Méthode IStillImageW ::GetDeviceInfo (sti.h)
La méthode IStillImage ::GetDeviceInfo retourne les caractéristiques matérielles d’un appareil d’image fixe 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, obtenue en appelant IStillImage ::GetSTILaunchInformation ou IStillImage ::GetDeviceList.
[out] ppBuffer
Reçoit un handle pour une structure 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 ::GetDeviceInfo retourne une structure STI_DEVICE_INFORMATION pour l’appareil d’image fixe spécifié. Le contenu de structure est généralement utilisé pour créer des affichages d’interface utilisateur.
Avant d’appeler IStillImage ::GetDeviceInfo, 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 la structure STI_DEVICE_INFORMATION référencée par ppBuffer, il doit libérer la mémoire tampon 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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour