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) |