Metodo IStillImageW::GetDeviceList (sti.h)
Il metodo IStillImage::GetDeviceList restituisce le caratteristiche hardware per tutti i dispositivi immagine ancora installati.
Sintassi
HRESULT GetDeviceList(
DWORD dwType,
DWORD dwFlags,
[out] DWORD *pdwItemsReturned,
[out] LPVOID *ppBuffer
);
Parametri
dwType
Parametro riservato, usare NULL.
dwFlags
Parametro riservato, usare NULL.
[out] pdwItemsReturned
Riceve il numero di strutture STI_DEVICE_INFORMATION fornite nel buffer a cui fa riferimento ppBuffer.
[out] ppBuffer
Riceve un handle in un buffer allocato da STI. Questo buffer conterrà una matrice di strutture 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::GetDeviceList restituisce una struttura STI_DEVICE_INFORMATION per ogni dispositivo ancora immagine installato. Il contenuto della struttura viene in genere usato per la creazione di visualizzazioni dell'interfaccia utente e per trovare il nome interno di un dispositivo.
Prima di chiamare IStillImage::GetDeviceList, i client dell'interfaccia IStillImage COM devono chiamare IStillImage::StiCreateInstance per ottenere un puntatore all'interfaccia IStillImage .
Al termine dell'utilizzo della matrice di strutture STI_DEVICE_INFORMATION a cui fa riferimento ppBuffer, deve deallocare la matrice chiamando LocalFree (descritto nella documentazione di Microsoft Windows SDK).
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | sti.h (include Sti.h) |