IEncoderAPI ::GetParameterRange, méthode (strmif.h)

[La fonctionnalité associée à cette page, Microsoft TV Technologies, est une fonctionnalité héritée. Microsoft recommande vivement que le nouveau code n’utilise pas cette fonctionnalité.]

[IEncoderAPI n’est plus disponible. Utilisez plutôt ICodecAPI.]

La méthode GetParameterRange récupère la plage de valeurs valide prise en charge par le paramètre, dans les cas où le paramètre prend en charge une plage échelonnée par opposition à une liste de valeurs spécifiques.

Syntaxe

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

Paramètres

[in] Api

Pointeur vers un GUID qui spécifie le paramètre.

[out] ValueMin

Pointeur vers un type VARIANT qui reçoit la valeur minimale du paramètre.

[out] ValueMax

Pointeur vers un type VARIANT qui reçoit la valeur maximale du paramètre.

[out] SteppingDelta

Pointeur vers un type VARIANT qui reçoit le delta d’étape, qui définit les incréments valides de ValueMin vers ValueMax.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Remarques

La plage valide pour le paramètre est [ValueMax... ValueMax], avec incréments de SteppingDelta. Si un paramètre prend en charge une plage de valeurs pas à pas, il doit utiliser l’un des types de variantes suivants :

• Types non signés : VT_UI8, VT_UI4, VT_UI2, VT_UI1
• Types signés : VT_I8, VT_I4, VT_I2
• Types float : VT_R8, VT_R4

Toute valeur de pas à pas est valide. Si la plage n’a pas de delta pas à pas (autrement dit, vous pouvez incrémenter d’une valeur quelconque), l’encodeur doit retourner une valeur vide (VT_EMPTY) pour SteppingDelta.

Si Api est égal à ENCAPIPARAM_BITRATE_MODE, la méthode retourne E_NOTIMPL, car les constantes de mode de débit sont une liste de valeurs spécifiques.

Configuration requise

Voir aussi

API encodeur

IEncoderAPI Interface