Freigeben über


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)