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

Article
03/01/2024

La méthode IStillImage ::GetDeviceValue retourne les informations de Registre associées à un appareil d’image fixe spécifié.

Syntaxe

HRESULT GetDeviceValue(
  [in]      LPWSTR  pwszDeviceName,
  [in]      LPWSTR  pValueName,
  [out]     LPDWORD pType,
  [out]     LPBYTE  pData,
  [in, out] LPDWORD cbData
);

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.

[in] pValueName

Pointeur fourni par l’appelant vers une chaîne représentant un nom de valeur de Registre.

[out] pType

Reçoit une constante représentant le type de données de la valeur de Registre retournée.

[out] pData

Pointeur fourni par l’appelant vers une mémoire tampon pour recevoir une valeur retournée.

[in, out] cbData

Taille fournie par l’appelant, en octets, de la mémoire tampon pointée par pData. La méthode modifie cette valeur pour représenter la taille des données retournées. Si la taille de mémoire tampon spécifiée est trop petite, la méthode fournit la taille de mémoire tampon requise et retourne un code d’erreur.

Valeur retournée

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

L’objectif de la méthode IStillImage ::GetDeviceValue est de retourner les valeurs actuellement affectées aux entrées de Registre spécifiques aux appareils pour les appareils à image fixe. La méthode appelle RegQueryValueEx (décrit dans la documentation Microsoft Windows SDK).

La méthode IStillImage ::GetDeviceValue peut retourner une chaîne ANSI ou Unicode. Elle peut retourner une chaîne Unicode uniquement si votre code est généré en tant qu’Unicode avec Unicode défini.

Avant d’appeler IStillImage ::GetDeviceValue, les clients de l’interface COM IStillImage doivent appeler IStillImage ::StiCreateInstance pour obtenir un pointeur d’interface IStillImage .

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	sti.h (inclure Sti.h)

Voir aussi

IStillImage ::SetDeviceValue

IStillImageW

Partager via