IEncoderAPI::GetParameterRange-Methode (strmif.h)

Artikel
03/02/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 verfügbar. Verwenden Sie stattdessen ICodecAPI.]

Die GetParameterRange-Methode ruft den gültigen Wertebereich ab, den der Parameter unterstützt, in Fällen, in denen der Parameter einen abgestuften Bereich im Gegensatz zu einer Liste bestimmter Werte unterstützt.

Syntax

HRESULT GetParameterRange(
  [in]  const GUID *Api,
  [out] VARIANT    *ValueMin,
  [out] VARIANT    *ValueMax,
  [out] VARIANT    *SteppingDelta
);

Parameter

[in] Api

Zeiger auf eine GUID, die den Parameter angibt.

[out] ValueMin

Zeiger auf einen VARIANT-Typ , der den Mindestwert des Parameters empfängt.

[out] ValueMax

Zeiger auf einen VARIANT-Typ , der den maximalen Wert des Parameters empfängt.

[out] SteppingDelta

Zeiger auf einen VARIANT-Typ , der das Schrittdelta empfängt, das die gültigen Inkremente von ValueMin auf ValueMax definiert.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_NOTIMPL	Die -Eigenschaft unterstützt eine Liste möglicher Werte, keinen linearen Bereich.

Hinweise

Der gültige Bereich für den Parameter ist [ValueMax... ValueMax], mit Inkrementen von SteppingDelta. Wenn ein Parameter einen abgestuften Wertebereich unterstützt, muss er einen der folgenden Variantentypen verwenden:

Typen ohne Vorzeichen: VT_UI8, VT_UI4, VT_UI2, VT_UI1
Signierte Typen: VT_I8, VT_I4, VT_I2
Floattypen: VT_R8, VT_R4

Definitionsgemäß gibt der Parameter einen bestimmten Typ zurück.

Jeder Schrittwert ist gültig. Wenn der Bereich kein Schrittdelta aufweist (d. h. Sie können um einen beliebigen Wert inkrementieren), sollte der Encoder einen leeren Wert (VT_EMPTY) für SteppingDelta zurückgeben.

Wenn apiENCAPIPARAM_BITRATE_MODE entspricht, gibt die Methode E_NOTIMPL zurück, da die Bitratenmoduskonstanten eine Liste bestimmter Werte sind.

Anforderungen

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

Weitere Informationen

Encoder-API

IEncoderAPI-Schnittstelle

Freigeben über