IMediaSample-Schnittstelle (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

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 Puffern mit freigegebenem Arbeitsspeicher 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 downstream-Filter zu übermitteln. Der downstream-Filter verwendet die -Schnittstelle, um die Eigenschaften abzurufen und die Daten zu lesen. Der Filter kann die Aktuellen Daten ändern, oder er kann das Beispiel kopieren, die Kopie ändern und die Kopie nach unten übergeben.

Die IMediaSample2-Schnittstelle erbt diese Schnittstelle.

Vererbung

Die IMediaSample-Schnittstelle erbt von der IUnknown-Schnittstelle . IMediaSample verfügt auch über folgende Membertypen:

Methoden

Die IMediaSample-Schnittstelle verfügt über diese Methoden.

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 Streamzeiten ab, zu denen dieses Beispiel beginnen und enden soll.
IMediaSample::IsDiscontinuity Die IsDiscontinuity-Methode bestimmt, ob dieses Beispiel einen Bruch 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 Bruch 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 Vorabrollbeispiel handelt.
IMediaSample::SetSyncPoint Die SetSyncPoint-Methode gibt an, ob der Anfang dieses Beispiels ein Synchronisierungspunkt ist.
IMediaSample::SetTime Die SetTime-Methode legt die Streamzeiten fest, zu denen dieses Beispiel beginnen und enden soll.

Anforderungen

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