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

  • Article

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

Notes

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

   
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