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) |