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

Article
03/01/2024

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

IStillImage ::GetDeviceList

IStillImageW

Partager via