Metodo IStillImageW::SetDeviceValue (sti.h)
Il metodo IStillImage::SetDeviceValue imposta le informazioni del Registro di sistema per un dispositivo immagine ancora 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
Dimensione fornita 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.
Osservazioni
Lo scopo del metodo IStillImage::SetDeviceValue consiste nell'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 interfaccia IStillImage::SetDeviceValue, i client dell'interfaccia IStillImage COM devono chiamare IStillImage::StiCreateInstance per ottenere un puntatore a interfaccia IStillImage .
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | sti.h (include Sti.h) |