Partager via


Méthode IStillImageW ::GetDeviceList (sti.h)

La méthode IStillImage ::GetDeviceList retourne des caractéristiques matérielles pour tous les appareils d’image fixe installés.

Syntaxe

HRESULT GetDeviceList(
        DWORD  dwType,
        DWORD  dwFlags,
  [out] DWORD  *pdwItemsReturned,
  [out] LPVOID *ppBuffer
);

Paramètres

dwType

Paramètre réservé, utilisez NULL.

dwFlags

Paramètre réservé, utilisez NULL.

[out] pdwItemsReturned

Reçoit le nombre de structures STI_DEVICE_INFORMATION fournies dans la mémoire tampon référencée par ppBuffer.

[out] ppBuffer

Reçoit un handle vers une mémoire tampon allouée par STI. Cette mémoire tampon contiendra un tableau de structures STI_DEVICE_INFORMATION .

Valeur retournée

Si l’opération réussit, la méthode retourne S_OK. Sinon, il retourne l’un des codes d’erreur préfixés STIERR définis dans stierr.h.

Remarques

La méthode IStillImage ::GetDeviceList retourne une structure STI_DEVICE_INFORMATION pour chaque appareil d’image fixe installé. Le contenu de structure est généralement utilisé pour créer des affichages d’interface utilisateur et pour rechercher le nom interne d’un appareil.

Avant d’appeler IStillImage ::GetDeviceList, les clients de l’interface COM IStillImage doivent appeler IStillImage ::StiCreateInstance pour obtenir un pointeur d’interface IStillImage .

Lorsque l’appelant a terminé d’utiliser le tableau de structures STI_DEVICE_INFORMATION référencées par ppBuffer, il doit libérer le tableau en appelant LocalFree (décrit dans la documentation Microsoft Windows SDK).

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête sti.h (inclure Sti.h)

Voir aussi

IStillImage ::GetDeviceInfo

IStillImageW