IMFSinkWriter::WriteSample-Methode (mfreadwrite.h)

Liefert ein Beispiel an den Senkenschreiber.

Syntax

HRESULT WriteSample(
  [in] DWORD     dwStreamIndex,
  [in] IMFSample *pSample
);

Parameter

[in] dwStreamIndex

Der nullbasierte Index des Datenstroms für dieses Beispiel.

[in] pSample

Ein Zeiger auf die IMFSample-Schnittstelle des Beispiels.

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

Sie müssen IMFSinkWriter::BeginWriting aufrufen, bevor Sie diese Methode aufrufen. Andernfalls gibt die Methode MF_E_INVALIDREQUEST zurück.

Standardmäßig begrenzt der Senkenschreiber die Rate der eingehenden Daten, indem der aufrufende Thread innerhalb der WriteSample-Methode blockiert wird. Dadurch wird verhindert, dass die Anwendung Zu schnell Beispiele liefert. Um dieses Verhalten zu deaktivieren, legen Sie beim Erstellen des Senkenschreibers das Attribut MF_SINK_WRITER_DISABLE_THROTTLING fest.

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