IEncoderAPI::GetParameterValues-Methode (strmif.h)

Artikel
03/13/2024

[Das feature, das dieser Seite zugeordnet ist, Microsoft TV Technologies, ist ein Legacyfeature. Microsoft empfiehlt dringend, dass neuer Code dieses Feature nicht verwendet.]

[IEncoderAPI ist nicht mehr zur Verwendung verfügbar. Verwenden Sie stattdessen ICodecAPI.]

Die GetParameterValues-Methode ruft die Liste der Werte ab, die vom angegebenen Parameter unterstützt werden.

Syntax

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

Parameter

[in] Api

Zeiger auf eine GUID, die den Parameter angibt.

[out] Values

Adresse eines Zeigers auf ein Array, das die Werte empfängt.

[out] ValuesCount

Gibt die Anzahl der Einträge an, die in das Array eingefügt werden.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode gibt ein Array von VARIANT-Typen zurück, die die einzelnen Werte darstellen, die vom Parameter unterstützt werden. Dieses Array wird vom Aufgerufenen über CoTaskMemAlloc zugeordnet und im Values-Parameter platziert. Beim Beenden enthält ValuesCount die Anzahl der Elemente im Array. Der Aufrufer muss das Array durch Aufrufen von CoTaskMemFree freigeben.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Weitere Informationen

Encoder-API

IEncoderAPI-Schnittstelle

Freigeben über