IStillImageW ::GetDeviceValue, méthode (sti.h)
La méthode IStillImage ::GetDeviceValue retourne les informations de Registre associées à un appareil d’image toujours 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, obtenu 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 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
L’objectif de la méthode IStillImage ::GetDeviceValue consiste à retourner les valeurs actuellement affectées aux entrées de Registre spécifiques à l’appareil pour les appareils toujours image. La méthode appelle RegQueryValueEx (décrit dans la documentation du Kit de développement logiciel (SDK) Microsoft Windows).
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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | sti.h (include Sti.h) |