IMediaSample-Schnittstelle (strmif.h)

Die IMediaSample Schnittstelle legt Eigenschaften für Medienbeispiele fest und ruft sie ab. Ein Medienbeispiel ist ein COM-Objekt, das einen Block von Mediendaten enthält. Medienbeispiele unterstützen die Verwendung von freigegebenen Speicherpuffern zwischen Filtern.

In der Regel rufen Anwendungen keine Methoden auf dieser Schnittstelle auf. Filter verwenden diese Schnittstelle, um Eigenschaften für Beispiele festzulegen und die Beispiele an einen nachgelagerten Filter bereitzustellen. Der nachgelagerte Filter verwendet die Schnittstelle, um die Eigenschaften abzurufen und die Daten zu lesen. Der Filter kann die Daten an Ort und Stelle ändern oder das Beispiel kopieren, die Kopie ändern und die Kopie nachgelagert übergeben.

Die IMediaSample2-Schnittstelle erbt diese Schnittstelle.

Vererbung

Die IMediaSample-Schnittstelle erbt von der IUnknown-Schnittstelle . IMediaSample verfügt auch über diese Arten von Mitgliedern:

Methoden

Die IMediaSample-Schnittstelle weist diese Methoden auf.

 
IMediaSample::GetActualDataLength

Die GetActualDataLength-Methode ruft die Länge der gültigen Daten im Puffer ab.
IMediaSample::GetMediaTime

Die GetMediaTime-Methode ruft die Medienzeiten für dieses Beispiel ab.
IMediaSample::GetMediaType

Die GetMediaType-Methode ruft den Medientyp ab, wenn sich der Medientyp vom vorherigen Beispiel unterscheidet.
IMediaSample::GetPointer

Die GetPointer-Methode ruft einen Lese-/Schreibzeiger auf den Puffer des Medienbeispiels ab.
IMediaSample::GetSize

Die GetSize-Methode ruft die Größe des Puffers ab.
IMediaSample::GetTime

Die GetTime-Methode ruft die Datenstromzeiten ab, zu denen dieses Beispiel beginnen und fertig stellen soll.
IMediaSample::IsDiscontinuity

Die IsDiscontinuity-Methode bestimmt, ob dieses Beispiel einen Umbruch im Datenstrom darstellt.
IMediaSample::IsPreroll

Die IsPreroll-Methode bestimmt, ob es sich bei diesem Beispiel um ein Vorabbeispiel handelt. Ein Vorabrollbeispiel sollte nicht angezeigt werden.
IMediaSample::IsSyncPoint

Die IsSyncPoint-Methode bestimmt, ob der Anfang dieses Beispiels ein Synchronisierungspunkt ist.
IMediaSample::SetActualDataLength

Die SetActualDataLength-Methode legt die Länge der gültigen Daten im Puffer fest.
IMediaSample::SetDiscontinuity

Die SetDiscontinuity-Methode gibt an, ob dieses Beispiel einen Umbruch im Datenstrom darstellt.
IMediaSample::SetMediaTime

Die SetMediaTime-Methode legt die Medienzeiten für dieses Beispiel fest.
IMediaSample::SetMediaType

Die SetMediaType-Methode legt den Medientyp für das Beispiel fest.
IMediaSample::SetPreroll

Die SetPreroll-Methode gibt an, ob es sich bei diesem Beispiel um ein Vorabbeispiel handelt.
IMediaSample::SetSyncPoint

Die SetSyncPoint-Methode gibt an, ob der Anfang dieses Beispiels ein Synchronisierungspunkt ist.
IMediaSample::SetTime

Die SetTime-Methode legt die Datenstromzeiten fest, wenn dieses Beispiel beginnen und fertig stellen soll.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile strmif.h (include Dshow.h)