Condividi tramite


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)

Vedere anche

IStillImage::GetDeviceInfo

IStillImageW