IStillImageW ::SetDeviceValue, méthode (sti.h)
La méthode IStillImage ::SetDeviceValue définit les informations de Registre pour un appareil toujours 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, 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.
Type
Type de valeur de Registre REG_ préfixé fourni par l’appelant. Pour plus d’informations, consultez RegSetValueEx dans la documentation du Kit de développement logiciel (SDK) Microsoft Windows.
[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 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 ::SetDeviceValue consiste à définir des valeurs pour les entrées de Registre spécifiques à l’appareil pour les appareils toujours image. La méthode appelle RegSetValueEx (décrit dans la documentation du Kit de développement logiciel (SDK) Microsoft Windows).
Avant d’appeler IStillImage ::SetDeviceValue, les clients de l’interface IStillImage COM 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) |