Propriétés de l’API codec

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

Propriétés audio courantes

Ces propriétés s’appliquent aux encodeurs audio et aux décodeurs audio.

Propriété Description
AVAudioChannelConfig Obtient la configuration du haut-parleur pour les canaux audio dans le flux de bits audio.
AVAudioChannelCount Obtient le nombre de canaux dans le flux de bits audio.
AVAudioSampleRate Obtient le taux d’échantillonnage du flux de bits audio, en exemples par seconde.
AVDDSurroundMode Spécifie si l’audio est encodé en Dolby Surround.

 

Propriétés communes du décodeur

Ces propriétés s’appliquent aux décodeurs audio et aux décodeurs vidéo.

Propriété Description
AVDecCommonInputFormat Spécifie le format d’entrée actuel pour le décodeur.
AVDecCommonMeanBitRate Obtient le débit binaire moyen actuel du décodeur.
AVDecCommonOutputFormat Spécifie le format de sortie du décodeur.
AVDecMmcssClass Spécifie la classe MMCSS (Multimedia Class Scheduler Service) pour le thread de décodage.

 

Propriétés courantes de l’encodeur

Ces propriétés s’appliquent aux encodeurs audio et aux encodeurs vidéo.

Propriété Description
AVEncCodecType Spécifie le schéma d’encodage.
AVEncCommonBufferInLevel Spécifie le niveau initial de la mémoire tampon d’encodage.
AVEncCommonBufferOutLevel Spécifie le niveau final de la mémoire tampon d’encodage à la fin du processus d’encodage.
AVEncCommonBufferSize Spécifie la taille de la mémoire tampon utilisée pendant l’encodage.
AVEncCommonFormatConstraint Spécifie le format cible d’un encodeur.
AVEncCommonLowLatency Spécifie si le flux de sortie doit être structuré de sorte que le flux encodé ait une faible latence de décodage.
AVEncCommonMaxBitRate Spécifie le débit binaire maximal.
AVEncCommonMeanBitRate Spécifie le débit binaire moyen.
AVEncCommonMeanBitRateInterval Spécifie l’intervalle de temps sur lequel le débit binaire moyen s’applique.
AVEncCommonMinBitRate Spécifie le débit binaire minimal.
AVEncCommonMultipassMode Spécifie le nombre de passes d’encodage que l’encodeur prend en charge.
AVEncCommonPassEnd Arrête la passe d’encodage actuelle ou demande si la passe d’encodage actuelle est la dernière.
AVEncCommonPassStart Démarre la première passe d’encodage.
AVEncCommonQuality Spécifie le niveau de qualité pour l’encodage.
AVEncCommonQualityVsSpeed Spécifie le compromis entre la qualité et la vitesse d’encodage.
AVEncCommonRateControlMode Spécifie le mode de contrôle de débit.
AVEncCommonRealTime Spécifie si l’application nécessite des performances d’encodage en temps réel.
AVEncCommonStreamEndHandling Spécifie si l’encodeur ignore des groupes d’images partiels (GOPs) à la fin du flux.
AVEncMuxOutputStreamType Spécifie le type de flux de sortie produit par un multiplexeur.
AVEncStatCommonCompletedPasses Spécifie le nombre de passes d’encodage terminées.

 

Propriétés du décodeur vidéo

Propriété Description
AVDecVideoAcceleration_H264 Active ou désactive l’accélération matérielle pour le décodage vidéo H.264.
AVDecVideoAcceleration_MPEG2 Active ou désactive l’accélération matérielle pour le décodage vidéo MPEG-2.
AVDecVideoAcceleration_VC1 Active ou désactive l’accélération matérielle pour le décodage vidéo VC-1.
AVDecVideoDropPicWithMissingRef Spécifie si le décodeur supprime les trames intra avec des trames de référence manquantes.
AVDecVideoFastDecodeMode Obtient ou définit la vitesse de décodage vidéo.
AVDecVideoImageSize Obtient la taille de l’image décodée, en pixels.
AVDecVideoInputScanType Spécifie la façon dont le flux vidéo décodé est entrelacé.
AVDecVideoPixelAspectRatio Spécifie les proportions en pixels du flux vidéo décodé.
AVDecVideoSoftwareDeinterlaceMode Spécifie le mode de désinterlacement logiciel du décodeur.
AVDecVideoSWPowerLevel Spécifie le niveau d’économie d’énergie.
AVDecVideoThumbnailGenerationMode Active ou désactive le mode de génération de miniatures.

 

Propriétés du décodeur audio

Propriété Description
AVDecAACDownmixMode Spécifie si un décodeur AAC utilise des équations de downmix stéréo MPEG-2/MPEG-4 standard ou un downmix non standard.
AVDecAudioDualMono Spécifie si l’audio à 2 canaux est encodé en stéréo ou en mono double.
AVDecAudioDualMonoReproMode Spécifie comment le décodeur reproduit l’audio mono double.
AVDecHEAACDynamicRangeControl Active ou désactive le contrôle de plage dynamique dans un décodeur AAC.

 

Propriétés de l’encodeur vidéo

Propriété Description
AVEncInputVideoSystem Spécifie le système vidéo du contenu source.
AVEncStatVideoCodedFrames Retourne le nombre de trames vidéo qui ont été encodées.
AVEncStatVideoOutputFrameRate Retourne la fréquence d’images moyenne du contenu vidéo.
AVEncStatVideoTotalFrames Retourne le nombre de trames vidéo que l’encodeur a reçues.
AVEncVideoCBRMotionTradeoff Spécifie le compromis entre le mouvement et les images fixes.
AVEncVideoCodedVideoAccessUnitSize Spécifie la taille des unités d’accès vidéo.
AVEncVideoDefaultUpperFieldDominant Spécifie le champ affiché en premier.
AVEncVideoDisplayDimension Spécifie la taille du flux vidéo lorsqu’il est décodé.
AVEncVideoEncodeDimension Spécifie la largeur et la hauteur de la vidéo encodée, si la vidéo est rognée.
AVEncVideoEncodeOffsetOrigin Spécifie les coins gauche et supérieur du rectangle de découpage, si la vidéo est rognée.
AVEncVideoFieldSwap Inverse l’ordre des champs entrelacés dans la vidéo source.
AVEncVideoForceSourceScanType Spécifie si les trames d’entrée sont progressives ou entrelacées.
AVEncVideoHeaderDropFrame Spécifie la valeur de l’indicateur drop-frame dans l’en-tête GOP.
AVEncVideoHeaderFrames Spécifie le numéro de trame de départ dans l’en-tête GOP.
AVEncVideoHeaderHours Spécifie le numéro d’heure de début dans l’en-tête GOP.
AVEncVideoHeaderMinutes Spécifie le numéro de la minute de début dans l’en-tête GOP.
AVEncVideoHeaderSeconds Spécifie le deuxième numéro de départ dans l’en-tête GOP.
AVEncVideoInputChromaResolution Spécifie la résolution chromatique de la vidéo d’entrée.
AVEncVideoInputChromaSubsampling Spécifie l’adresse chromatique de la vidéo d’entrée.
AVEncVideoInputColorLighting Spécifie les conditions d’éclairage prévues pour l’affichage de la vidéo d’entrée.
AVEncVideoInputColorNominalRange Spécifie la plage nominale de la vidéo d’entrée.
AVEncVideoInputColorPrimaries Spécifie les couleurs primaires pour la vidéo d’entrée.
AVEncVideoInputColorTransferFunction Spécifie la fonction de conversion RVB en R’G’B' pour la vidéo d’entrée
AVEncVideoInputColorTransferMatrix Spécifie la matrice de conversion de l’espace colorimétrique Y’Cb’Cr' en espace de couleur R’G’B' pour la vidéo d’entrée.
AVEncVideoInverseTelecineEnable Spécifie si l’encodeur effectue une télécine inverse.
AVEncVideoInverseTelecineThreshold Définit le seuil auquel l’encodeur considère qu’un champ vidéo est redondant.
AVEncVideoMaxKeyframeDistance Spécifie le nombre maximal d’images entre les images clés.
AVEncVideoNoOfFieldsToEncode Spécifie le nombre de champs à encoder.
AVEncVideoNoOfFieldsToSkip Spécifie le nombre de champs à ignorer pendant l’encodage.
AVEncVideoOutputChromaResolution Spécifie la résolution chromatique de la vidéo encodée.
AVEncVideoOutputChromaSubsampling Spécifie l’adresse chromatique de la vidéo encodée.
AVEncVideoOutputColorLighting Spécifie les conditions d’éclairage prévues pour l’affichage de la vidéo encodée.
AVEncVideoOutputColorNominalRange Spécifie la plage nominale de la vidéo encodée.
AVEncVideoOutputColorPrimaries Spécifie les couleurs primaires pour la vidéo encodée.
AVEncVideoOutputColorTransferFunction Spécifie la fonction de conversion RVB en R’G’B' pour la vidéo encodée.
AVEncVideoOutputColorTransferMatrix Spécifie la matrice de conversion de l’espace de couleur Y’Cb’Cr' en espace de couleur R’G’B' pour la vidéo encodée.
AVEncVideoOutputFrameRate Spécifie la fréquence d’images sur le flux de sortie de l’encodeur, en images par seconde.
AVEncVideoOutputFrameRateConversion Spécifie si l’encodeur convertit la fréquence d’images lorsque la fréquence d’images de sortie ne correspond pas à la fréquence d’images d’entrée.
AVEncVideoOutputScanType Spécifie la façon dont l’encodeur entrelace la vidéo de sortie.
AVEncVideoPixelAspectRatio Spécifie le rapport d’aspect en pixels.
AVEncVideoSourceFilmContent Spécifie si la source d’origine de la vidéo d’entrée était un film ou une vidéo.
AVEncVideoSourceIsBW Spécifie si la vidéo est monochrome (noir et blanc) ou contient une couleur.

 

Propriétés de l’encodeur audio

Propriété Description
AVEncAudioDualMono Spécifie si l’audio à 2 canaux est encodé en stéréo ou double mono.
AVEncAudioInputContent Spécifie si le contenu audio contient de la musique ou de la voix.
AVEncAudioIntervalToEncode Spécifie le nombre d’exemples audio à encoder.
AVEncAudioIntervalToSkip Spécifie le nombre d’exemples audio à ignorer pour l’encodeur.
AVEncAudioMapDestChannel N Spécifie quel canal audio est mappé au canal N dans le flux audio encodé.
AVEncAudioMeanBitRate Spécifie le débit binaire moyen du flux audio encodé.
AVEncStatAudioAverageBPS Retourne les bits moyens par seconde de l’audio encodé.
AVEncStatAudioAveragePCMValue Retourne le niveau de volume moyen du contenu audio.
AVEncStatAudioPeakPCMValue Retourne le niveau de volume le plus élevé présent dans le contenu audio.

 

Propriétés de l’encodeur vidéo MPEG

Propriété Description
AVEncMPVAddSeqEndCode Spécifie si l’encodeur ajoute un code de fin de séquence à la fin du flux.
AVEncMPVDefaultBPictureCount Spécifie le nombre par défaut d’images B consécutives entre les images I et P.
AVEncMPVFrameFieldMode Spécifie si l’encodeur produit des champs encodés ou des trames encodées.
AVEncMPVGenerateHeaderPicDispExt Spécifie si l’encodeur génère des en-têtes d’extension d’affichage d’image.
AVEncMPVGenerateHeaderPicExt Spécifie si l’encodeur génère des en-têtes d’extension d’image.
AVEncMPVGenerateHeaderSeqDispExt Spécifie si l’encodeur génère des en-têtes d’extension d’affichage de séquence.
AVEncMPVGenerateHeaderSeqExt Spécifie si l’encodeur génère des en-têtes d’extension de séquence.
AVEncMPVGenerateHeaderSeqScaleExt Spécifie si l’encodeur génère des en-têtes d’extension évolutifs de séquence.
AVEncMPVGOPOpen Spécifie si l’encodeur produit des goPs ouverts ou des goPs fermés.
AVEncMPVGOPSInSeq Spécifie le nombre de gops entre les en-têtes de séquence.
AVEncMPVGOPSize Spécifie le nombre maximal d’images d’un en-tête GOP vers l’en-tête goP suivant.
AVEncMPVIntraDCPrecision Spécifie la précision des coefficients DC.
AVEncMPVIntraVLCTable Spécifie la table de codage de longueur variable (VLC) à utiliser pour le codage entropie.
AVEncMPVLevel Spécifie le niveau MPEG-2.
AVEncMPVProfile Spécifie le profil MPEG-2.
AVEncMPVQScaleType Spécifie si l’échelle du quantizer est linéaire ou non linéaire.
AVEncMPVQuantMatrixChromaIntra Spécifie la matrice de quantification de chroma pour les macroblocks intra.
AVEncMPVQuantMatrixChromaNonIntra Spécifie la matrice de quantification chromatique pour les macroblocks non intra.
AVEncMPVQuantMatrixIntra Spécifie la matrice de quantization luma pour les macroblocks intra.
AVEncMPVQuantMatrixNonIntra Spécifie la matrice de quantization luma pour les macroblocks non intra.
AVEncMPVScanPattern Spécifie le modèle d’analyse macroblock.
AVEncMPVSceneDetection Spécifie le comportement de l’encodeur lorsqu’il détecte une nouvelle scène.
AVEncMPVUseConcealmentMotionVectors Spécifie si l’encodeur utilise des vecteurs de mouvement de dissimulation.

 

Propriétés de l’encodeur audio MPEG

Propriété Description
AVEncMPACodingMode Spécifie le mode d’encodage audio MPEG-1.
AVEncMPACopyright Spécifie le paramètre par défaut pour le bit de copyright.
AVEncMPAEmphasisType Spécifie le type de filtre de dé-emphase qui doit être utilisé lors du décodage.
AVEncMPAEnableRedundancyProtection Spécifie s’il faut ajouter une case activée de redondance cyclique (CRC) à l’en-tête de trame.
AVEncMPALayer Spécifie la couche audio MPEG.
AVEncMPAOriginalBitstream Spécifie le paramètre par défaut pour le bit d’origine.
AVEncMPAPrivateUserBit Définit la valeur du bit utilisateur privé.

 

Propriétés du décodeur audio numérique Dolby

Propriété Description
AVDecDDDynamicRangeScaleHigh Spécifie la coupe de haut niveau lorsque le décodeur effectue un contrôle de plage dynamique.
AVDecDDDynamicRangeScaleLow Spécifie l’augmentation de bas niveau lorsque le décodeur effectue un contrôle de plage dynamique.
AVDecDDOperationalMode Spécifie le mode de contrôle de compression.

 

Propriétés de l’encodeur audio numérique Dolby

Propriété Description
AVEncDDAtoDConverterType Spécifie le type de conversion analogique-numérique (A/D).
AVEncDDCentreDownMixLevel Spécifie le niveau central de mixage inférieur.
AVEncDDChannelBWLowPassFilter Spécifie si un filtre passe-bas est appliqué aux canaux d’entrée main.
AVEncDDCopyright Spécifie l’indicateur de copyright.
AVEncDDDCHighPassFilter Spécifie si un filtre de passage élevé bloquant le contrôleur de domaine est appliqué.
AVEncDDDialogNormalization Spécifie le niveau de normalisation de la boîte de dialogue.
AVEncDDDigitalDeemphasis Spécifie si l’accent est mis sur le numérique.
AVEncDDDynamicRangeCompressionControl Spécifie le profil de contrôle de plage dynamique.
AVEncDDHeadphoneMode Spécifie le mode casque.
AVEncDDLFELowPassFilter Spécifie si un filtre passe-bas est appliqué au canal de l’effet basse fréquence (LFE).
AVEncDDLoRoCenterMixLvl_x10 Spécifie le décalage de niveau appliqué au canal central pour le mixage inférieur Lo/Ro.
AVEncDDLoRoSurroundMixLvl_x10 Spécifie le décalage de niveau appliqué aux canaux Surround pour le mixage descendant Lo/Ro.
AVEncDDLtRtCenterMixLvl_x10 Spécifie le décalage de niveau appliqué au canal central pour le mixage inférieur Lt/Rt.
AVEncDDLtRtSurroundMixLvl_x10 Spécifie le décalage de niveau appliqué aux canaux Surround pour le mixage inférieur Lt/Rt.
AVEncDDOriginalBitstream Spécifie l’indicateur de flux de bits d’origine.
AVEncDDPreferredStereoDownMixMode Spécifie le mode de mixage stéréo préféré.
AVEncDDProductionInfoExists Spécifie l’indicateur d’informations de production audio.
AVEncDDProductionMixLevel Spécifie le niveau de mélange.
AVEncDDProductionRoomType Spécifie le type de salle.
AVEncDDRFPreEmphasisFilter Spécifie le paramètre de protection contre la surmodulation RF.
AVEncDDService Spécifie le service audio.
AVEncDDSurround3dBAttenuation Spécifie si les canaux Surround sont atténués avant l’encodage.
AVEncDDSurround90DegreeePhaseShift Spécifie si un décalage de phase de 90 degrés est appliqué aux canaux Surround.
AVEncDDSurroundDownMixLevel Spécifie le niveau de mixage Surround vers le bas.
AVEncDDSurroundExMode Spécifie si le flux audio est encodé dans Surround EX.

 

Propriétés du traitement du signal numérique (DSP)

Propriété Description
AVDSPLoudnessEqualization Active ou désactive l’égalisation du bruit
AVDSPSpeakerFill Active ou désactive le remplissage de l’orateur

 

Informations de référence sur l’API codec