IMFHttpDownloadRequest::BeginReadPayload-Methode (mfidl.h)

  • Artikel

Wird von Microsoft Media Foundation aufgerufen, um den Nachrichtentext der Antwort auf eine zuvor gesendete HTTP- oder HTTPS-Anforderung zu empfangen. Media Foundation ruft diese Methode erst auf, nachdem die EndReceiveResponse-Methode erfolgreich aufgerufen wurde. Da die Größe des Nachrichtentexts groß oder unbekannt sein kann, kann Media Foundation diese Methode mehrmals aufrufen, um den Nachrichtentext schrittweise abzurufen.

Syntax

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

Parameter

[out] pb

Zeiger auf einen Puffer, der die Daten empfängt.

[in] cb

Gibt die Größe des Pb-Puffers in Bytes an.

[in] pCallback

Zeiger auf die IMFAsyncCallback-Schnittstelle eines Rückrufobjekts, das von Microsoft Media Foundation implementiert wird.

punkState

Zeiger auf die IUnknown-Schnittstelle eines Zustandsobjekts, das von Microsoft Media Foundation definiert wird. 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
 Der asynchrone Vorgang wurde erfolgreich gestartet.

Hinweise

Microsoft Media Foundation ruft BeginReadPayload nie auf, während ein vorheriger Aufruf von BeginReadPayload noch nicht abgeschlossen wurde.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 10, Version 1703 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mfplat.lib; Mfplat.dll

Weitere Informationen

IMFHttpDownloadRequest