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)

Vedi anche

IStillImage::GetDeviceInfo

IStillImageW