énumération tagAM_SAMPLE_PROPERTY_FLAGS (strmif.h)

Article
07/28/2023

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

Spécifie les valeurs de la structure AM_SAMPLE2_PROPERTIES . Ces valeurs décrivent les propriétés des exemples multimédias.

Syntax

typedef enum tagAM_SAMPLE_PROPERTY_FLAGS {
  AM_SAMPLE_SPLICEPOINT = 0x1,
  AM_SAMPLE_PREROLL = 0x2,
  AM_SAMPLE_DATADISCONTINUITY = 0x4,
  AM_SAMPLE_TYPECHANGED = 0x8,
  AM_SAMPLE_TIMEVALID = 0x10,
  AM_SAMPLE_TIMEDISCONTINUITY = 0x40,
  AM_SAMPLE_FLUSH_ON_PAUSE = 0x80,
  AM_SAMPLE_STOPVALID = 0x100,
  AM_SAMPLE_ENDOFSTREAM = 0x200,
  AM_STREAM_MEDIA = 0,
  AM_STREAM_CONTROL = 1
} ;

Constantes


`AM_SAMPLE_SPLICEPOINT` Valeur : 0x1 L’exemple est un point d’épissage (il peut être décodé sans référence aux données précédentes).
`AM_SAMPLE_PREROLL` Valeur : 0x2 L’exemple est un exemple de préroll.
`AM_SAMPLE_DATADISCONTINUITY` Valeur : 0x4 Les données initiales de cet exemple sont un point d’épissage. Les données de l’exemple précédent n’étaient pas destinées à être suivies des données de cet exemple. Pour plus d'informations, consultez la section Notes.
`AM_SAMPLE_TYPECHANGED` Valeur : 0x8 Type d’exemple modifié.
`AM_SAMPLE_TIMEVALID` Valeur : 0x10 L’heure est valide.
`AM_SAMPLE_TIMEDISCONTINUITY` Valeur : 0x40 Un intervalle de temps dans les données commence après cet exemple. La structure AM_SAMPLE2_PROPERTIES peut être NULL dans ce cas.
`AM_SAMPLE_FLUSH_ON_PAUSE` Valeur : 0x80 Pour les données actives uniquement ; indique ignorer dans l’état suspendu.
`AM_SAMPLE_STOPVALID` Valeur : 0x100 L’heure d’arrêt est valide.
`AM_SAMPLE_ENDOFSTREAM` Valeur : 0x200 La fin du flux se produit après cet exemple. Cet indicateur est réservé à la diffusion en continu du noyau. Actuellement, DirectShow ne l’utilise pas.
`AM_STREAM_MEDIA` Valeur : 0 Identificateur de flux de données normal.
`AM_STREAM_CONTROL` Valeur : 1 Identificateur de flux de contrôle. Une valeur supérieure à 0x7FFFFFFF indique un flux défini par l’application.

Remarques

L’indicateur AM_SAMPLE_DATADISCONTINUITY indique que les données de l’exemple multimédia actuel ne sont pas considérées comme contiguës avec les données des exemples précédents. Un filtre recevant un exemple avec le jeu d’indicateurs AM_SAMPLE_DATADISCONTINUITY ne doit pas ignorer les données non traitées dans ses mémoires tampons. Un filtre qui attend les données entrantes avant de pouvoir traiter les données mises en mémoire tampon doit traiter les données mises en mémoire tampon immédiatement ; par conséquent, les données mises en mémoire tampon peuvent être ignorées si elles sont incomplètes.

Par exemple, un filtre de décompresseur vidéo peut recevoir un exemple multimédia avec l’indicateur AM_SAMPLE_DATADISCONTINUITY défini lorsqu’il a deux images vidéo compressées complètes et une image vidéo compressée incomplète dans ses mémoires tampons. Dans ce cas, le filtre décompresse les deux images complètes et ignore la troisième image incomplète avant de commencer à traiter les données de l’exemple multimédia actuel.

L’indicateur AM_SAMPLE_DATADISCONTINUITY est défini sur le premier échantillon reçu à la suite d’un vidage ou d’un arrêt. En outre, vous devez utiliser l’indicateur AM_SAMPLE_DATADISCONTINUITY lorsque le contenu est basculé dans la source, lorsqu’un changement de canal se produit (lorsqu’il peut également y avoir un changement de format) ou lorsqu’il manque des données en raison d’interruptions de flux.

L’indicateur AM_SAMPLE_DATADISCONTINUITY équivaut à la méthode IMediaSample ::IsDiscontinuity qui retourne S_OK.

Configuration requise

Condition requise	Valeur
En-tête	strmif.h (include DShow.h)

Voir aussi

Types énumérés DirectShow

Partager via