IStillImageW::GetDeviceValue-Methode (sti.h)

Die IStillImage::GetDeviceValue Methode gibt Registrierungsinformationen zurück, die einem angegebenen Stillbildgerä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 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 in Bytes, auf den pData-verweist. 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 eine der STIERR-Präfixfehlercodes zurückgegeben, die in stierr.hdefiniert sind.

Bemerkungen

Der Zweck der IStillImage::GetDeviceValue Methode besteht darin, die derzeit gerätespezifischen Registrierungseinträge für Still Image Deviceszurückzugeben. 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. Sie kann eine Unicode-Zeichenfolge nur zurückgeben, wenn Ihr Code als Unicode mit Unicode-Definition erstellt wird.

Vor dem Aufrufen IStillImage::GetDeviceValuemüssen Clients der IStillImage- COM-Schnittstelle IStillImage::StiCreateInstance aufrufen, um einen IStillImage Schnittstellenzeiger abzurufen.

Anforderungen

Siehe auch

IStillImage::SetDeviceValue

IStillImageW-