IEncoderAPI::GetParameterRange-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 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.

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

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

Weitere Informationen

Encoder-API

IEncoderAPI-Schnittstelle