IMFSinkWriter::P laceMarker-Methode (mfreadwrite.h)

Artikel
02/28/2024

Places einen Marker im angegebenen Stream.

Syntax

HRESULT PlaceMarker(
  [in] DWORD  dwStreamIndex,
  [in] LPVOID pvContext
);

Parameter

[in] dwStreamIndex

Der nullbasierte Index des Streams.

[in] pvContext

Zeiger auf einen anwendungsdefinierten Wert. Der Wert dieses Parameters wird an den Aufrufer im pvContext-Parameter der IMFSinkWriterCallback::OnMarker-Rückrufmethode des Aufrufers zurückgegeben. Die Anwendung ist für alle Speicherbelegungen verantwortlich, die mit diesen Daten verknüpft sind. Dieser Parameter kann NULL sein.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	Beschreibung
S_OK	Die Methode wurde erfolgreich ausgeführt.
MF_E_INVALIDREQUEST	Die Anforderung ist ungültig.

Hinweise

Um diese Methode verwenden zu können, müssen Sie beim Erstellen des Senkenschreibers einen asynchronen Rückruf bereitstellen. Andernfalls gibt die Methode MF_E_INVALIDREQUEST zurück. Weitere Informationen finden Sie unter MF_SINK_WRITER_ASYNC_CALLBACK.

Marker bieten eine Möglichkeit, benachrichtigt zu werden, wenn die Mediensenke bis zu einem bestimmten Punkt alle Proben in einem Stream verbraucht. Die Mediensenke verarbeitet den Marker erst, wenn er alle Proben vor dem Marker verarbeitet hat. Wenn die Mediensenke den Marker verarbeitet, ruft der Senkenschreiber die OnMarker-Methode der Anwendung auf. Wenn der Rückruf aufgerufen wird, wissen Sie, dass die Senke alle vorherigen Beispiele für diesen Stream verbraucht hat.

Um beispielsweise das Format midstream zu ändern, rufen Sie PlaceMarker an der Stelle auf, an der sich das Format ändert. Wenn OnMarker aufgerufen wird, ist es sicher, IMFSinkWriter::SetInputMediaType aufzurufen, um den Eingabetyp zu ändern (vorausgesetzt, die Mediensenke unterstützt dynamische Formatänderungen).

Intern ruft diese Methode IMFStreamSink::P laceMarker für die Mediensenke auf.

Hinweis Der pvContext-Parameter der IMFSinkWriter::P laceMarker-Methode wird nicht an den pvarContextValue-Parameter der IMFStreamSink::P laceMarker-Methode übergeben. Diese beiden Parameter stehen nicht direkt in Beziehung.

Diese Schnittstelle ist unter Windows Vista verfügbar, wenn das Plattformupdate-Supplement für Windows Vista installiert ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Ergänzung zu Windows 7, Windows Vista und Plattformupdates für Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	mfreadwrite.h

Weitere Informationen

IMFSinkWriter

Sink Writer

Share via