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

Article
08/24/2023

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

ValueMax

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

Notes

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.

Spécifications


Client minimal pris en charge	Windows 10 Build 20348
Serveur minimal pris en charge	Windows 10 Build 20348
En-tête	icodecapi.h

Voir aussi

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

API encodeur

ICodecAPI

Partager via