Interface IEncoderAPI (strmif.h)

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

L’interface IEncoderAPI définit un moyen standard pour les applications et les pilotes de communiquer avec des encodeurs matériels ou logiciels tiers qui implémentent l’interface. Pour plus d’informations sur cette interface, consultez API Encodeur.

Héritage

L’interface IEncoderAPI hérite de l’interface IUnknown. IEncoderAPI possède également les types de membres suivants :

• Méthodes

Méthodes

L’interface IEncoderAPI a ces méthodes.

IEncoderAPI ::GetDefaultValue La méthode GetDefaultValue récupère la valeur par défaut d’un paramètre, le cas échéant.
IEncoderAPI ::GetParameterRange 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.
IEncoderAPI ::GetParameterValues La méthode GetParameterValues récupère la liste des valeurs prises en charge par le paramètre donné.
IEncoderAPI ::GetValue La méthode GetValue récupère la valeur actuelle d’un paramètre spécifié.
IEncoderAPI ::IsAvailable IEncoderAPI n’est plus disponible. (IEncoderAPI.IsAvailable)
IEncoderAPI ::IsSupported La méthode IsSupported demande si un paramètre donné est pris en charge.
IEncoderAPI ::SetValue La méthode SetValue définit la valeur actuelle d’un paramètre.

Remarques

Dans les différentes méthodes d’interface, les GUID suivants, définis dans uuids.h, sont utilisés pour indiquer quel paramètre est défini ou récupéré.

Paramètre	Description
ENCAPIPARAM_BITRATE	Spécifie le débit binaire, en bits par seconde. En mode débit binaire constant (CBR), la valeur donne le débit binaire constant. Dans l’un ou l’autre des modes de débit variable, il donne le débit binaire moyen. La valeur est une longueur non signée 32 bits.
ENCAPIPARAM_PEAK_BITRATE	Spécifie le débit de pointe. Ce paramètre n’est pertinent que lorsque ENCAPIPARAM_BITRATE_MODE a été défini sur VariableBitRatePeak.
ENCAPIPARAM_BITRATE_MODE	Spécifie le mode de débit binaire, en tant que valeur d’énumération VIDEOENCODER_BITRATE_MODE (long signé 32 bits).

�

Le tableau suivant décrit le comportement attendu d’un encodeur dans des conditions de débit extrêmement élevé ou faible dans les deux modes de débit variable définis dans VIDEOENCODER_BITRATE_MODE.

Condition	Mode	Comportement
La scène tombe au noir ou il n’y a aucun mouvement	VariableBitRateAverage	Sur une courte période (plusieurs secondes), le débit binaire passe en dessous du taux spécifié pour le paramètre ENCAPIPARAM_BITRATE. Mais sur une période de quatre minutes, l’encodeur maintient le débit moyen, si nécessaire en ajoutant des bits « factices » au flux.
La scène tombe au noir ou il n’y a aucun mouvement.	VariableBitRatePeak	Le débit est inférieur au débit attendu, comme spécifié dans la valeur du paramètre ENCAPIPARAM_BITRATE. Le taux restera à ce niveau jusqu’à ce qu’une scène plus compliquée commence.
La scène est extrêmement complexe.	VariableBitRateAverage	Pendant quelques secondes, le taux va monter. Si la scène reste complexe, le taux redescend et l’image devient bloquée afin de maintenir la moyenne comme spécifié dans la valeur du paramètre ENCAPIPARAM_BITRATE.
La scène est extrêmement complexe.	VariableBitRatePeak	Le taux va monter et rester à la hausse, éventuellement au-dessus du taux attendu tel que spécifié dans la valeur du paramètre ENCAPIPARAM_BITRATE, mais jamais au-dessus du pic spécifié dans le paramètre ENCAPIPARAM_PEAK_BITRATE.

�

Appareils OCUR

Cette interface prend en charge les appareils OCUR (OpenCable Unidirectional Cable Receiver). Consultez Appareils OCUR.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)

Voir aussi

API encodeur