ICodecAPI::GetParameterValues-Methode (icodecapi.h)

Die GetParameterValues-Methode ruft die Liste der möglichen Werte für eine Codeceigenschaft ab.

Diese Methode gilt nur für Eigenschaften, die eine Liste möglicher Werte unterstützen, im Gegensatz zu einem linearen Bereich.

Syntax

HRESULT GetParameterValues(
  [in]  const GUID *Api,
  [out] VARIANT    **Values,
  [out] ULONG      *ValuesCount
);

Parameter

[in] Api

Zeiger auf eine GUID, die die abzufragende Eigenschaft angibt. Eine Liste der Standardcodeceigenschaften finden Sie unter Codec-API-Eigenschaften.

[out] Values

Empfängt einen Zeiger auf ein Array von VARIANT-Typen . Das Array enthält die Liste der Werte, die der Encoder für diese Eigenschaft unterstützt. Der Aufrufer muss jeden VARIANT durch Aufrufen von VariantClear freigeben. Der Aufrufer muss das Array auch durch Aufrufen von CoTaskMemFree freigeben.

[out] ValuesCount

Empfängt die Anzahl der Elemente im Wertearray .

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_INVALIDARG	Ungültiges Argument.
VFW_E_CODECAPI_LINEAR_RANGE	Die -Eigenschaft unterstützt einen Wertebereich, keine Liste.

Hinweise

Wenn die -Eigenschaft einen Bereich von Werten unterstützt, gibt die Methode anstelle einer Liste VFW_E_CODECAPI_LINEAR_RANGE zurück. Rufen Sie in diesem Fall ICodecAPI::GetParameterRange auf, um den Wertebereich abzurufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10 Build 20348
Unterstützte Mindestversion (Server)	Windows 10 Build 20348
Kopfzeile	icodecapi.h

Weitere Informationen

Codec-API-Referenz

Encoder-API

ICodecAPI