IEncoderAPI::GetParameterValues-Methode (strmif.h)
[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 |