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

Article
08/24/2023

La méthode GetParameterValues obtient la liste des valeurs possibles pour une propriété de codec.

Cette méthode s’applique uniquement aux propriétés qui prennent en charge une liste de valeurs possibles, par opposition à une plage linéaire.

Syntaxe

HRESULT GetParameterValues(
  [in]  const GUID *Api,
  [out] VARIANT    **Values,
  [out] ULONG      *ValuesCount
);

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] Values

Reçoit un pointeur vers un tableau de types VARIANT . Le tableau contient la liste des valeurs que l’encodeur prend en charge pour cette propriété. L’appelant doit libérer chaque VARIANT en appelant VariantClear. L’appelant doit également libérer le tableau en appelant CoTaskMemFree.

[out] ValuesCount

Reçoit le nombre d’éléments dans le tableau Valeurs .

Valeur retournée

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

Code de retour	Description
S_OK	S_OK
E_INVALIDARG	Argument non valide.
VFW_E_CODECAPI_LINEAR_RANGE	La propriété prend en charge une plage de valeurs, pas une liste.

Remarques

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

Configuration requise

Condition requise	Valeur
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