énumération MF_TRANSCODE_ADJUST_PROFILE_FLAGS (mfidl.h)

Article
08/24/2023

Définit les indicateurs de profil définis dans l’attribut MF_TRANSCODE_ADJUST_PROFILE .

Ces indicateurs sont vérifiés par MFCreateTranscodeTopology lors de la génération de la topologie. En fonction de ces indicateurs, MFCreateTranscodeTopology ajuste le profil de transcode en modifiant les paramètres de configuration des flux en fonction des exigences d’entrée de l’encodeur utilisé dans la topologie.

Pour plus d’informations sur les paramètres de flux qu’une application peut spécifier, consultez Utilisation de l’API Transcode.

Syntax

typedef enum _MF_TRANSCODE_ADJUST_PROFILE_FLAGS {
  MF_TRANSCODE_ADJUST_PROFILE_DEFAULT = 0,
  MF_TRANSCODE_ADJUST_PROFILE_USE_SOURCE_ATTRIBUTES = 1
} MF_TRANSCODE_ADJUST_PROFILE_FLAGS;

Constantes


`MF_TRANSCODE_ADJUST_PROFILE_DEFAULT` Valeur : 0 Media Foundation utilise les paramètres spécifiés par l’application pour les flux audio et vidéo. Si les paramètres requis ne sont pas fournis par l’application, la topologie est créée, mais la session d’encodage échoue. Pour le flux vidéo, les paramètres de fréquence d’images et de mode entrelacé sont modifiés. Pour plus d'informations, consultez la section Notes.
`MF_TRANSCODE_ADJUST_PROFILE_USE_SOURCE_ATTRIBUTES` Valeur : 1 Pour les flux audio et vidéo, les paramètres de flux manquants sont renseignés en copiant les attributs source d’entrée. Cet indicateur garantit que le fichier de sortie transcodé est la correspondance la plus proche du fichier d’entrée.

MF_TRANSCODE_ADJUST_PROFILE_DEFAULT
Valeur : 0
Media Foundation utilise les paramètres spécifiés par l’application pour les flux audio et vidéo. Si les paramètres requis ne sont pas fournis par l’application, la topologie est créée, mais la session d’encodage échoue. Pour le flux vidéo, les paramètres de fréquence d’images et de mode entrelacé sont modifiés. Pour plus d'informations, consultez la section Notes.

MF_TRANSCODE_ADJUST_PROFILE_USE_SOURCE_ATTRIBUTES
Valeur : 1
Pour les flux audio et vidéo, les paramètres de flux manquants sont renseignés en copiant les attributs source d’entrée. Cet indicateur garantit que le fichier de sortie transcodé est la correspondance la plus proche du fichier d’entrée.

Notes

Si l’indicateur MF_TRANSCODE_ADJUST_PROFILE_DEFAULT est spécifié, les modifications suivantes sont apportées au flux vidéo :

Si la fréquence d’images de la source multimédia spécifiée dans le paramètre pSrc de MFCreateTranscodeTopology et la fréquence d’images spécifiée par l’application dans l’attribut MF_MT_FRAME_RATE diffèrent de moins de 1/1000, le profil utilise la fréquence d’images de la source multimédia. Cela est dû au fait que le pipeline considère la différence comme négligeable.
Si l’application ne spécifie pas de mode entrelacé en définissant l’attribut MF_MT_INTERLACE_MODE , le profil est modifié pour utiliser des images progressives.

L’indicateur MF_TRANSCODE_ADJUST_PROFILE_DEFAULT doit être accompagné des attributs de flux audio et vidéo requis fournis par l’application. Pour le flux audio, les attributs requis sont les suivants :

Pour le flux vidéo, les attributs requis sont les suivants :

Si ces attributs ne sont pas définis, MFCreateTranscodeTopology crée la topologie, mais Media Session ne parvient pas à générer le fichier encodé. Le code d’échec dépend du nœud MFT dans la topologie. Par exemple, si l’application ne définit pas la taille d’image, l’encodeur WMV ne parvient pas à encoder le contenu et l’application obtient le code d’erreur MF_E_INVALIDMEDIATYPE via la session multimédia.

Utilisez l’indicateur MF_TRANSCODE_ADJUST_PROFILE_USE_SOURCE_ATTRIBUTES lorsque vous souhaitez transcoder le fichier à l’aide des attributs de flux d’entrée. Les attributs de flux source d’entrée sont copiés dans le type de média de sortie avant que le nœud MFT soit inséré dans la topologie. Si vous définissez des attributs de flux supplémentaires, cet indicateur ne remplace pas les valeurs définies. Seuls les attributs manquants sont remplis avec les valeurs d’attribut de la source d’entrée. Cet indicateur est utile dans le scénario remux où vous souhaitez générer le fichier de sortie au même format que la source d’entrée. Si vous souhaitez effectuer une conversion de format, veillez à définir l’attribut MF_MT_SUBTYPE du flux pour spécifier l’encodeur que le générateur de topologie doit utiliser. Le nœud de transformation est ajouté dans la topologie, sauf si MF_TRANSCODE_DONOT_INSERT_ENCODER est défini. Dans ce cas, et le contenu n’est pas encodé. Au lieu de cela, si le conteneur l’autorise, le contenu est incorporé dans le conteneur spécifié.

Par exemple, supposons que votre source d’entrée est un fichier MP3. Vous définissez le conteneur sur MFTranscodeContainerType_ASF, vous ne définissez aucun attribut de flux et vous définissez l’indicateur MF_TRANSCODE_ADJUST_PROFILE_USE_SOURCE_ATTRIBUTES . Dans ce cas, le fichier de sortie généré est un fichier ASF (.wma) contenant des données multimédias MP3. Notez que si vous utilisez cet indicateur, certains attributs de flux d’entrée et le type de conteneur peuvent ne pas être compatibles.

Spécifications


Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
En-tête	mfidl.h

Voir aussi

Énumérations Media Foundation

Transcode API

Partager via