Partager via

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, IMFMediaEngineet audio/vidéo capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et 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 à la fois 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 échantillons par seconde.
AVDDSurroundMode Spécifie si l’audio est encodé dans Dolby Surround.

 

Propriétés du décodeur commun

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 taux de bits 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 à la fois 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é afin que le flux encodé ait une faible latence de décodage.
AVEncCommonMaxBitRate Spécifie le débit maximal de bits.
AVEncCommonMeanBitRate Spécifie le taux de bits moyen.
AVEncCommonMeanBitRateInterval Spécifie l’intervalle de temps sur lequel le taux de bits moyen s’applique.
AVEncCommonMinBitRate Spécifie le débit 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 interroge 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 les groupes partiels d’images (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 le rapport d’aspect de pixels du flux vidéo décodé.
AVDecVideoSoftwareDeinterlaceMode Spécifie le mode de déinterlace logiciel du décodeur.
AVDecVideoSWPowerLevel Spécifie le niveau d’économie d’alimentation.
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 stéréo MPEG-2/MPEG-4 standard ou utilise un mélange inférieur non standard.
AVDecAudioDualMono Spécifie si l’audio à 2 canaux est encodé en tant que mono stéréo ou double.
AVDecAudioDualMonoReproMode Spécifie la façon dont le décodeur reproduit l’audio double mono.
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 d’images vidéo qui ont été encodées.
AVEncStatVideoOutputFrameRate Retourne la fréquence moyenne d’images du contenu vidéo.
AVEncStatVideoTotalFrames Retourne le nombre d’images vidéo reçues par l’encodeur.
AVEncVideoCBRMotionTradeoff Spécifie le compromis entre le mouvement et les images toujours.
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 images 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 minute de départ 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 le paramètre 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 primaires de couleur pour la vidéo d’entrée.
AVEncVideoInputColorTransferFunction Spécifie la fonction de conversion de RVB en R’G’B pour la vidéo d’entrée
AVEncVideoInputColorTransferMatrix Spécifie la matrice de conversion de l’espace de couleur Y’Cb’Cr' à l’espace de couleurs 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 un champ vidéo redondant.
AVEncVideoMaxFrameDistance 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 le paramètre 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 primaires de couleur pour la vidéo encodée.
AVEncVideoOutputColorTransferFunction Spécifie la fonction de conversion de RVB en R’G’B pour la vidéo encodée.
AVEncVideoOutputColorTransferMatrix Spécifie la matrice de conversion de l’espace de couleurs Y’Cb’Cr' à l’espace de couleurs 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 comment l’encodeur interlace la vidéo de sortie.
AVEncVideoPixelAspectRatio Spécifie le rapport d’aspect des pixels.
AVEncVideoSourceFilmContent Spécifie si la source d’origine de la vidéo d’entrée a été filmée ou 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 tant que mono stéréo ou double.
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 que l’encodeur doit ignorer.
AVEncAudioMapDestChannel N Spécifie le canal audio mappé au canal N dans le flux audio encodé.
AVEncAudioMeanBitRate Spécifie le taux de bits 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 scalable de séquence.
AVEncMPVGOPOpen Spécifie si l’encodeur produit des adresses GOPs ouvertes ou fermées.
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 à 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 à 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 quantisation chromatique pour les macroblocks intra.
AVEncMPVQuantMatrixChromaNonIntra Spécifie la matrice de quantisation chromatique pour les macroblocks non intra-intra.
AVEncMPVQuantMatrixIntra Spécifie la matrice de quantisation luma pour les macroblocks intra.
AVEncMPVQuantMatrixNonIntra Spécifie la matrice de quantisation luma pour les macroblocages non intra-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é-accentuation qui doit être utilisé lors du décodage.
AVEncMPAEnableRedundancyProtection Spécifie s’il faut ajouter une vérification de redondance cyclique (CRC) à l’en-tête d’image.
AVEncMPALayer Spécifie la couche audio MPEG.
AVEncMPAOriginalBitstream Spécifie le paramètre par défaut du bit d’origine.
AVEncMPAPrivateUserBit Définit la valeur du bit utilisateur privé.

 

Propriétés du décodeur Dolby Digital Audio

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’amélioration 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
AVEncDAtoDConverterType Spécifie le type de conversion analogique à numérique (A/D).
AVEncDCentreDownMixLevel Spécifie le niveau de mixage central inférieur.
AVEncDChannelBWLowPassFilter Spécifie si un filtre pass faible est appliqué aux canaux d’entrée principaux.
AVEncDCopyright Spécifie l’indicateur de copyright.
AVEncDDCHighPassFilter Spécifie si un filtre de passe élevée bloquant le contrôleur de domaine est appliqué.
AVEncDDialogNormalization Spécifie le niveau de normalisation de la boîte de dialogue.
AVEncDDDigitalDeemphasis Spécifie si l’accentuation numérique.
AVEncDDDynamicRangeCompressionControl Spécifie le profil de contrôle de plage dynamique.
AVEncDHeadphoneMode Spécifie le mode casque.
AVEncDLFELowPassFilter Spécifie si un filtre pass faible est appliqué au canal LFE (Low Frequency Effect).
AVEncDDLoRoCenterMixLvl_x10 Spécifie le décalage de niveau appliqué au canal central pour lo/ro downmixing.
AVEncDDLoRoSurroundMixLvl_x10 Spécifie le décalage de niveau appliqué aux canaux Surround pour le mixage lo/ro.
AVEncDDLtRtCenterMixLvl_x10 Spécifie le décalage de niveau appliqué au canal central pour Lt/Rt downmixing.
AVEncDDLtRtSurroundMixLvl_x10 Spécifie le décalage de niveau appliqué aux canaux Surround pour Lt/Rt downmixing.
AVEncDOriginalBitstream Spécifie l’indicateur de flux de bits d’origine.
AVEncDDPreferredStereoDownMixMode Spécifie le mode hi-bas stéréo préféré.
AVEncDProductionInfoExists Spécifie l’indicateur d’informations de production audio.
AVEncDProductionMixLevel Spécifie le niveau de mélange.
AVEncDDProductionRoomType Spécifie le type de salle.
AVEncDRFPreEmphasisFilter Spécifie le paramètre de protection contre la surmodulation RF.
AVEncDService Spécifie le service audio.
AVEncDSurround3dBAttenuation Spécifie si les canaux Surround sont atténués avant l’encodage.
AVEncDSurround90DegreeePhaseShift Spécifie si un décalage de phase de 90 degrés est appliqué aux canaux Surround.
AVEncDSurroundDownMixLevel Spécifie le niveau de combinaison Entourer vers le bas.
AVEncDSurroundExMode Spécifie si le flux audio est encodé dans Surround EX.

 

Propriétés DSP (Digital Signal Processing)

Propriété Description
AVDSPLoudnessEqualization Active ou désactive l’égalisation de la forte intensité
AVDSPSpeakerFill Active ou désactive le remplissage de l’orateur

 

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