Freigeben über


IMFByteStream::BeginWrite-Methode (mfobjects.h)

Startet einen asynchronen Schreibvorgang in den Stream.

Syntax

HRESULT BeginWrite(
  [in] const BYTE       *pb,
  [in] ULONG            cb,
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *punkState
);

Parameter

[in] pb

Zeiger auf einen Puffer, der die zu schreibenden Daten enthält.

[in] cb

Größe des Puffers in Byte.

[in] pCallback

Zeiger auf die IMFAsyncCallback-Schnittstelle eines Rückrufobjekts. Der Aufrufer muss diese Schnittstelle implementieren.

[in] punkState

Zeiger auf die IUnknown-Schnittstelle eines Zustandsobjekts, das vom Aufrufer definiert wird. Dieser Parameter kann NULL sein. Sie können dieses Objekt verwenden, um Zustandsinformationen aufzunehmen. Das -Objekt wird an den Aufrufer zurückgegeben, wenn der Rückruf aufgerufen wird.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn alle Daten in den Stream geschrieben wurden, wird die IMFAsyncCallback::Invoke-Methode des Rückrufobjekts aufgerufen. Zu diesem Zeitpunkt sollte die Anwendung IMFByteStream::EndWrite aufrufen, um die asynchrone Anforderung abzuschließen.

Stellen Sie den Puffer nicht neu zu, frei oder schreiben Sie sie nicht in den Puffer, während ein asynchroner Schreibvorgang noch aussteht.

Implementierungshinweise:Diese Methode sollte die aktuelle Position im Stream aktualisieren, indem die Anzahl der Bytes, die in den Stream geschrieben werden, die durch den im pcbWritten zurückgegebenen Wert angegeben wird, zur aktuellen Position hinzugefügt wird. Weitere Methoden, die die aktuelle Position aktualisieren können, sind Read, BeginRead, Write, Seek und SetCurrentPosition.

Diese Schnittstelle ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Windows Media Format 11 SDK-Komponenten installiert sind:

  • Windows XP mit Service Pack 2 (SP2) und höher.
  • Windows XP Media Center Edition 2005 mit KB900325 (Windows XP Media Center Edition 2005) und KB925766 (Updaterollup für Windows XP Media Center Edition vom Oktober 2006) installiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfobjects.h (include Mfidl.h)
Bibliothek Mfuuid.lib

Weitere Informationen

IMFByteStream