Partager via


Interface IMediaSample (strmif.h)

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in 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 Audio/Video Capture dans Media Foundation au lieu de DirectShow, si 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.]

L’interface IMediaSample définit et récupère des propriétés sur des exemples multimédias. Un exemple de média est un objet COM qui contient un bloc de données multimédias. Les exemples de médias prennent en charge l’utilisation de mémoire tampons partagées entre les filtres.

En règle générale, les applications n’appellent pas de méthodes sur cette interface. Les filtres utilisent cette interface pour définir des propriétés sur des exemples et les remettre à un filtre en aval. Le filtre en aval utilise l’interface pour récupérer les propriétés et lire les données. Le filtre peut modifier les données en place, ou il peut copier l’exemple, modifier la copie et passer la copie en aval.

L’interface IMediaSample2 hérite de cette interface.

Héritage

L’interface IMediaSample hérite de l’interface IUnknown . IMediaSample a également les types de membres suivants :

Méthodes

L’interface IMediaSample a ces méthodes.

 
IMediaSample ::GetActualDataLength

La méthode GetActualDataLength récupère la longueur des données valides dans la mémoire tampon.
IMediaSample ::GetMediaTime

La méthode GetMediaTime récupère les heures de média pour cet exemple.
IMediaSample ::GetMediaType

La méthode GetMediaType récupère le type de média, si le type de média diffère de l’exemple précédent.
IMediaSample ::GetPointer

La méthode GetPointer récupère un pointeur en lecture/écriture vers la mémoire tampon de l’exemple de média.
IMediaSample ::GetSize

La méthode GetSize récupère la taille de la mémoire tampon.
IMediaSample ::GetTime

La méthode GetTime récupère les heures de flux auxquelles cet exemple doit commencer et se terminer.
IMediaSample ::IsDiscontinuity

La méthode IsDiscontinuity détermine si cet exemple représente une rupture dans le flux de données.
IMediaSample ::IsPreroll

La méthode IsPreroll détermine si cet exemple est un exemple de pré-inscription. Un exemple de préroll ne doit pas être affiché.
IMediaSample ::IsSyncPoint

La méthode IsSyncPoint détermine si le début de cet exemple est un point de synchronisation.
IMediaSample ::SetActualDataLength

La méthode SetActualDataLength définit la longueur des données valides dans la mémoire tampon.
IMediaSample ::SetDiscontinuity

La méthode SetDiscontinuity spécifie si cet exemple représente une rupture dans le flux de données.
IMediaSample ::SetMediaTime

La méthode SetMediaTime définit les heures de média pour cet exemple.
IMediaSample ::SetMediaType

La méthode SetMediaType définit le type de média de l’exemple.
IMediaSample ::SetPreroll

La méthode SetPreroll spécifie si cet exemple est un exemple de préroll.
IMediaSample ::SetSyncPoint

La méthode SetSyncPoint spécifie si le début de cet exemple est un point de synchronisation.
IMediaSample ::SetTime

La méthode SetTime définit les heures de début et de fin de cet exemple.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête strmif.h (include Dshow.h)