IMFByteStream::BeginRead-Methode (mfobjects.h)

  • Artikel

Startet einen asynchronen Lesevorgang aus dem Stream.

Syntax

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

Parameter

[in] pb

Zeiger auf einen Puffer, der die Daten empfängt. Der Aufrufer muss den Puffer zuordnen.

[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 zu enthalten. 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 Puffer gelesen wurden, wird die IMFAsyncCallback::Invoke-Methode des Rückrufobjekts aufgerufen. An diesem Punkt sollte die Anwendung IMFByteStream::EndRead aufrufen, um die asynchrone Anforderung abzuschließen.

Lesen Sie den Puffer nicht aus, schreiben Sie es in, geben Sie frei, oder ordnet den Puffer nicht neu zu, während ein asynchroner Lesevorgang aussteht.

Implementierungshinweise:Diese Methode sollte die aktuelle Position im Stream aktualisieren, indem die Anzahl der gelesenen Bytes, die durch den im parameter pcbRead zurückgegebenen Wert angegeben wird, zur aktuellen Position hinzugefügt wird. Weitere Methoden, die die aktuelle Position aktualisieren können, sind BeginRead, Write, BeginWrite, 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