IStillImageW::SetDeviceValue-Methode (sti.h)
Die IStillImage::SetDeviceValue Methode legt Registrierungsinformationen für ein angegebenes Stillbildgerä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 IStillImage::GetSTILaunchInformation oder IStillImage::GetDeviceList.
[in] pValueName
Vom Aufrufer bereitgestellter Zeiger auf eine Zeichenfolge, die einen Registrierungswertnamen darstellt.
Type
Vom Aufrufer bereitgestellte REG_-Präfix-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 in Bytes, auf die durch pData-verwiesen wird. Schließen Sie für NULL-beendete Zeichenfolgen das NULL-Zeichen ein.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt die Methode S_OK zurück. Andernfalls wird eine der STIERR-Präfixfehlercodes zurückgegeben, die in stierr.hdefiniert sind.
Bemerkungen
Der Zweck der IStillImage::SetDeviceValue Methode besteht darin, Werte für gerätespezifische Registrierungseinträge für stille Bildgerätefestzulegen. Die Methode ruft RegSetValueEx- auf (in der Microsoft Windows SDK-Dokumentation beschrieben).
Vor dem Aufrufen IStillImage::SetDeviceValuemüssen Clients der IStillImage COM-Schnittstelle IStillImage::StiCreateInstance aufrufen, um einen IStillImage Schnittstellenzeiger abzurufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | sti.h (einschließlich Sti.h) |