Metodo IStillImageW::GetDeviceInfo (sti.h)

Il metodo IStillImage::GetDeviceInfo restituisce caratteristiche hardware per un dispositivo di immagine ancora specificato.

Sintassi

HRESULT GetDeviceInfo(
  [in]  LPWSTR pwszDeviceName,
  [out] LPVOID *ppBuffer
);

Parametri

[in] pwszDeviceName

Puntatore fornito dal chiamante a una stringa che rappresenta un nome di dispositivo interno, ottenuto chiamando IStillImage::GetSTILaunchInformation o IStillImage::GetDeviceList.

[out] ppBuffer

Riceve un handle in una struttura STI_DEVICE_INFORMATION .

Valore restituito

Se l'operazione ha esito positivo, il metodo restituisce S_OK. In caso contrario, restituisce uno dei codici di errore con prefisso STIERR definiti in stierr.h.

Commenti

Il metodo IStillImage::GetDeviceInfo restituisce una struttura STI_DEVICE_INFORMATION per il dispositivo ancora immagine specificato. I contenuti della struttura vengono in genere usati per la creazione di un'interfaccia utente.

Prima di chiamare IStillImage::GetDeviceInfo, i client dell'interfaccia COM IStillImage devono chiamare IStillImage::StiCreateInstance per ottenere un puntatore dell'interfaccia IStillImage.

Al termine dell'uso della struttura STI_DEVICE_INFORMATION a cui fa riferimento ppBuffer, il chiamante LocalFree (descritto nella documentazione di Microsoft Windows SDK).

Requisiti

Vedi anche

IStillImage::GetDeviceList

IStillImageW