Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
[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 pour une utilisation. 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 l’API Encoder.
Héritage
L’interface IEncoderAPI hérite de l’interface IUnknown . IEncoderAPI possède également ces types de membres :
- 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 pas à pas 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 pour une utilisation. (IEncoderAPI.IsAvailable) |
|
IEncoderAPI ::IsSupported La méthode IsSupported interroge 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 taux de bits, en bits par seconde. En mode CBR (Constant Bit Rate), la valeur donne le débit binaire constant. En mode de débit binaire variable, il donne le taux de bits moyen. La valeur est une valeur non signée 32 bits. |
| ENCAPIPARAM_PEAK_BITRATE | Spécifie le débit de bits maximal. Ce paramètre est pertinent uniquement lorsque ENCAPIPARAM_BITRATE_MODE a été défini sur VariableBitRatePeak. |
| ENCAPIPARAM_BITRATE_MODE | Spécifie le mode de débit binaire, sous la forme d’une valeur d’énumération VIDEOENCODER_BITRATE_MODE (32 bits signé long). |
Le tableau suivant décrit le comportement attendu d’un encodeur sous des conditions extrêmement élevées ou à débit binaire faible dans les deux modes de vitesse de transmission variable définis dans VIDEOENCODER_BITRATE_MODE.
| Condition | Mode | Comportement |
|---|---|---|
| La scène tombe en noir ou il y a zéro mouvement | VariableBitRateAverage | Sur une courte période (plusieurs secondes), le taux de bits tombe en dessous du taux spécifié pour le paramètre ENCAPIPARAM_BITRATE. Mais sur une période de quatre minutes, l’encodeur maintient le taux moyen, si nécessaire, en ajoutant des bits « factices » au flux. |
| La scène tombe en noir ou il y a zéro mouvement. | VariableBitRatePeak | Le débit binaire tombe en dessous du taux attendu tel que 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 revient et l’image devient bloquée afin de conserver la moyenne spécifiée 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 tel que spécifié dans le paramètre ENCAPIPARAM_PEAK_BITRATE. |
Appareils OCUR
Cette interface prend en charge les appareils OCUR (OpenCable Unidirectional Cable Receiver). Consultez les appareils OCUR.
Exigences
| Requirement | Valeur |
|---|---|
| plateforme cible | Windows |
| En-tête | strmif.h (include Dshow.h) |