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)

Weitere Informationen

IStillImage::SetDeviceValue

IStillImageW