Partager via


IStillImageW ::GetDeviceList, méthode (sti.h)

La méthode IStillImage ::GetDeviceList retourne des caractéristiques matérielles pour tous les appareils encore image 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 contient un tableau de structures STI_DEVICE_INFORMATION.

Valeur de retour

Si l’opération réussit, la méthode retourne S_OK. Sinon, elle 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 toujours-image installé. Le contenu de la 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 du Kit de développement logiciel (SDK) Microsoft Windows).

Exigences

Exigence Valeur
plateforme cible Bureau
d’en-tête sti.h (include Sti.h)

Voir aussi

IStillImage ::GetDeviceInfo

IStillImageW