IStillImageW ::GetDeviceInfo, méthode (sti.h)
La méthode IStillImage ::GetDeviceInfo retourne les caractéristiques matérielles d’un appareil toujours spécifié.
Syntaxe
HRESULT GetDeviceInfo(
[in] LPWSTR pwszDeviceName,
[out] LPVOID *ppBuffer
);
Paramètres
[in] pwszDeviceName
Pointeur fourni par l’appelant vers une chaîne représentant un nom d’appareil interne, obtenu en appelant IStillImage ::GetSTILaunchInformation ou IStillImage ::GetDeviceList.
[out] ppBuffer
Reçoit un handle vers une structure 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 ::GetDeviceInfo retourne une structure STI_DEVICE_INFORMATION pour l’appareil still-image spécifié. Le contenu de la structure est généralement utilisé pour créer des affichages d’interface utilisateur.
Avant d’appeler IStillImage ::GetDeviceInfo, les clients de l’interface IStillImage COM doivent appeler IStillImage ::StiCreateInstance pour obtenir un pointeur d’interface IStillImage.
Lorsque l’appelant a terminé d’utiliser la structure de STI_DEVICE_INFORMATION référencée par ppBuffer, elle doit libérer la mémoire tampon 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) |