IMFSinkWriter::P laceMarker-Methode (mfreadwrite.h)
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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
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.
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 |