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

Article
03/04/2024

[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.

Code de retour	Description
S_OK	S_OK
E_NOTIMPL	La propriété prend en charge une liste de valeurs possibles, et non une plage linéaire.

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

Par définition, le paramètre retourne un type spécifique.

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

Condition requise	Valeur
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

API encodeur

IEncoderAPI Interface

Partager via