Metodo IStillImageW::GetDeviceInfo (sti.h)
Il metodo IStillImage::GetDeviceInfo restituisce caratteristiche hardware per un dispositivo 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 per 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.
Osservazioni
Il metodo IStillImage::GetDeviceInfo restituisce una struttura STI_DEVICE_INFORMATION per il dispositivo ancora ancora specificato. Il contenuto della struttura viene in genere usato per la creazione di visualizzazioni dell'interfaccia utente.
Prima di chiamare interfaccia IStillImage::GetDeviceInfo, i client dell'interfaccia IStillImage COM devono chiamare IStillImage::StiCreateInstance per ottenere un puntatore all'interfaccia IStillImage .
Al termine dell'utilizzo della struttura di STI_DEVICE_INFORMATION a cui fa riferimento ppBuffer, deve deallocare il buffer chiamando LocalFree (descritto nella documentazione di Microsoft Windows SDK).
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | sti.h (include Sti.h) |