IStillImageW::GetDeviceValue-Methode (sti.h)
Die IStillImage::GetDeviceValue-Methode gibt Registrierungsinformationen zurück, die einem angegebenen Standbildgerät zugeordnet sind.
Syntax
HRESULT GetDeviceValue(
[in] LPWSTR pwszDeviceName,
[in] LPWSTR pValueName,
[out] LPDWORD pType,
[out] LPBYTE pData,
[in, out] LPDWORD 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.
[out] pType
Empfängt eine Konstante, die den Datentyp des zurückgegebenen Registrierungswerts darstellt.
[out] pData
Vom Aufrufer bereitgestellter Zeiger auf einen Puffer, um einen zurückgegebenen Wert zu empfangen.
[in, out] cbData
Vom Aufrufer bereitgestellte Größe des Puffers, auf den pData verweist, in Bytes. Die -Methode ändert diesen Wert so, dass er die Größe der zurückgegebenen Daten darstellt. Wenn die angegebene Puffergröße zu klein ist, stellt die Methode die erforderliche Puffergröße bereit und gibt einen Fehlercode zurück.
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::GetDeviceValue-Methode besteht darin, die Werte zurückzugeben, die derzeit gerätespezifischen Registrierungseinträgen für Standbildgeräte zugewiesen sind. Die Methode ruft RegQueryValueEx auf (in der Microsoft Windows SDK-Dokumentation beschrieben).
Die IStillImage::GetDeviceValue-Methode kann entweder eine ANSI- oder eine Unicode-Zeichenfolge zurückgeben. Es kann eine Unicode-Zeichenfolge nur zurückgegeben werden, wenn Ihr Code als Unicode mit Unicode-Definition erstellt wurde.
Vor dem Aufrufen von IStillImage::GetDeviceValue müssen Clients der IStillImage-COM-Schnittstelle IStillImage::StiCreateInstance aufrufen, um einen IStillImage-Schnittstellenzeiger abzurufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | sti.h (einschließlich Sti.h) |