ICodecAPI::GetParameterValues-Methode (strmif.h)
[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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Ungültiges Argument. |
|
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 |