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

Article
02/26/2024

La méthode IStillImage ::SetDeviceValue définit les informations de Registre pour un appareil d’image fixe spécifié.

Syntaxe

HRESULT SetDeviceValue(
  [in] LPWSTR pwszDeviceName,
  [in] LPWSTR pValueName,
       DWORD  Type,
  [in] LPBYTE pData,
       DWORD  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.

Type

Type de valeur de Registre REG_ préfixé par l’appelant. Pour plus d’informations, consultez RegSetValueEx dans la documentation Microsoft Windows SDK.

[in] pData

Pointeur fourni par l’appelant vers les données à stocker.

cbData

Taille fournie par l’appelant, en octets, des données pointées par pData. Pour les chaînes terminées par NULL, incluez le caractère NULL.

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

L’objectif de la méthode IStillImage ::SetDeviceValue est de définir des valeurs pour les entrées de Registre spécifiques à l’appareil pour les appareils à image fixe. La méthode appelle RegSetValueEx (décrit dans la documentation Microsoft Windows SDK).

Avant d’appeler IStillImage ::SetDeviceValue, 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 ::GetDeviceValue

IStillImageW

Partager via