IStillImageW::SetDeviceValue-Methode (sti.h)

Die IStillImage::SetDeviceValue-Methode legt Registrierungsinformationen für ein angegebenes Standbildgerät fest.

Syntax

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

Parameter

[in] pwszDeviceName

Vom Aufrufer bereitgestellter Zeiger auf eine Zeichenfolge, die einen internen Gerätenamen darstellt, abgerufen durch Aufrufen von IStillImage::GetSTILaunchInformation oder IStillImage::GetDeviceList.

[in] pValueName

Vom Aufrufer bereitgestellter Zeiger auf eine Zeichenfolge, die einen Registrierungswertnamen darstellt.

Type

Vom Aufrufer bereitgestellter REG_ Registrierungswerttyp. Weitere Informationen finden Sie unter RegSetValueEx in der Microsoft Windows SDK-Dokumentation.

[in] pData

Vom Aufrufer bereitgestellter Zeiger auf die zu speichernden Daten.

cbData

Vom Aufrufer bereitgestellte Größe der Daten, auf die pData verweist, in Bytes. Schließen Sie für NULL-Zeichenfolgen das NULL-Zeichen ein.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Methode S_OK zurück. Andernfalls wird einer der in stierr.h definierten Fehlercodes mit STIERR-Präfix zurückgegeben.

Hinweise

Der Zweck der IStillImage::SetDeviceValue-Methode besteht darin, Werte für gerätespezifische Registrierungseinträge für Standbildgeräte festzulegen. Die -Methode ruft RegSetValueEx auf (in der Microsoft Windows SDK-Dokumentation beschrieben).

Vor dem Aufrufen von IStillImage::SetDeviceValue müssen Clients der IStillImage-COM-SchnittstelleIStillImage::StiCreateInstance aufrufen, um einen IStillImage-Schnittstellenzeiger abzurufen.

Anforderungen

Weitere Informationen

IStillImage::GetDeviceValue

IStillImageW