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

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La méthode GetParameterRange obtient la plage de valeurs d’une propriété de codec.

Cette méthode s’applique uniquement aux propriétés dont les valeurs forment une plage linéaire.

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 la propriété à interroger. Pour obtenir la liste des propriétés de codec standard, consultez Propriétés de l’API de codec.

[out] ValueMin

Pointeur vers un VARIANT qui reçoit la valeur minimale de la propriété. L’appelant doit libérer le VARIANT en appelant VariantClear.

[out] ValueMax

Pointeur vers un VARIANT qui reçoit la valeur maximale de la propriété. L’appelant doit libérer le VARIANT en appelant VariantClear.

[out] SteppingDelta

Pointeur vers un VARIANT qui reçoit le delta d’étape, qui définit les incréments valides de ValueMin vers ValueMax. L’appelant doit libérer le VARIANT en appelant VariantClear.

Si le type VARIANT est VT_EMPTY, tout incrément est valide.

Valeur retournée

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

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

Remarques

La plage valide pour la propriété est [ValueMin... ValueMax], avec incréments de SteppingDelta. Si une propriété prend en charge une plage linéaire de valeurs, la propriété 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 à virgule flottante : VT_R8, VT_R4

Si la propriété prend en charge une liste de valeurs, au lieu d’une plage, la méthode retourne VFW_E_CODECAPI_ENUMERATED. Dans ce cas, appelez ICodecAPI ::GetParameterValues pour obtenir la liste des valeurs.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2 [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows Server 2003 R2 [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

Informations de référence sur l’API codec

API encodeur

ICodecAPI