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) |