ICodecAPI::GetParameterValues-Methode (strmif.h)

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

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-Wert 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.

Bemerkungen

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

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP mit SP2 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile strmif.h (include Dshow.h)
Bibliothek Strmiids.lib

Siehe auch

Codec-API-Referenz

Encoder-API

ICodecAPI