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
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | sti.h (einschließlich Sti.h) |