Metodo IStillImageW::GetDeviceList (sti.h)
Il metodo IStillImage::GetDeviceList restituisce caratteristiche hardware per tutti i dispositivi 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.
Commenti
Il metodo IStillImage::GetDeviceList restituisce una struttura STI_DEVICE_INFORMATION per ogni dispositivo ancora installato. I contenuti della struttura vengono in genere usati per la creazione di un'interfaccia utente e per trovare il nome interno di un dispositivo.
Prima di chiamare IStillImage::GetDeviceList, i client dell'interfaccia COM IStillImage devono chiamare IStillImage::StiCreateInstance per ottenere un puntatore dell'interfaccia IStillImage.
Al termine dell'uso 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).
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | sti.h (include Sti.h) |