Metodo IStillImageW::SetDeviceValue (sti.h)

Il metodo IStillImage::SetDeviceValue imposta le informazioni del Registro di sistema per un dispositivo ancora immagine specificato.

Sintassi

HRESULT SetDeviceValue(
  [in] LPWSTR pwszDeviceName,
  [in] LPWSTR pValueName,
       DWORD  Type,
  [in] LPBYTE pData,
       DWORD  cbData
);

Parametri

[in] pwszDeviceName

Puntatore fornito dal chiamante a una stringa che rappresenta un nome di dispositivo interno, ottenuto chiamando IStillImage::GetSTILaunchInformation o IStillImage::GetDeviceList.

[in] pValueName

Puntatore fornito dal chiamante a una stringa che rappresenta un nome di valore del Registro di sistema.

Type

Tipo di valore del Registro di sistema con prefisso REG_ fornito dal chiamante. Per altre informazioni, vedere RegSetValueEx nella documentazione di Microsoft Windows SDK.

[in] pData

Puntatore fornito dal chiamante ai dati da archiviare.

cbData

Dimensioni fornite dal chiamante, in byte, dei dati a cui punta pData. Per le stringhe con terminazione NULL, includere il carattere NULL.

Valore restituito

Se l'operazione ha esito positivo, il metodo restituisce S_OK. In caso contrario, restituisce uno dei codici di errore con prefisso STIERR definiti in stierr.h.

Commenti

Lo scopo del metodo IStillImage::SetDeviceValue è impostare i valori per le voci del Registro di sistema specifiche del dispositivo per i dispositivi ancora immagine. Il metodo chiama RegSetValueEx (descritto nella documentazione di Microsoft Windows SDK).

Prima di chiamare IStillImage::SetDeviceValue, i client dell'interfaccia COM IStillImage devono chiamare IStillImage::StiCreateInstance per ottenere un puntatore all'interfaccia IStillImage .

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	sti.h (include Sti.h)

Vedi anche

IStillImage::GetDeviceValue

IStillImageW