IMFHttpDownloadRequest::EndReadPayload-Methode (mfidl.h)

  • Artikel

Wird von Microsoft Media Foundation aufgerufen, um den asynchronen Vorgang abzuschließen, der von BeginReadPayload gestartet wurde. Wenn diese Methode erfolgreich abgeschlossen wurde, wurden die Nutzlastdaten in den Puffer geschrieben, den Media Foundation beim Aufrufen von BeginReadPayload bereitgestellt hat.

Syntax

HRESULT EndReadPayload(
  [in]  IMFAsyncResult *pResult,
  [out] QWORD          *pqwOffset,
  [out] ULONG          *pcbRead
);

Parameter

[in] pResult

Zeiger auf die IMFAsyncResult-Schnittstelle . Microsoft Media Foundation übergibt denselben Zeiger, den das Rückrufobjekt in der IMFAsyncCallback::Invoke-Methode empfangen hat.

[out] pqwOffset

Der Offset des ersten Byte, das in den Puffer geschrieben wird, relativ zum vollständigen Nachrichtentext der aktuellen HTTP-Anforderung. Wenn Media Foundation beispielsweise BeginReadPayload zum ersten Mal für einen bestimmten IMFHttpDownloadRequest aufruft und eine Puffergröße von 100 angibt, wird der pqwOffset-Parameter auf 0 festgelegt. Wenn Media Foundation dann BeginReadPayload zum zweiten Mal für dieselbe IMNFHttpDownloadRequest aufruft, wird der pqwOffset-Parameter auf 100 festgelegt.

[out] pcbRead

Gibt die Anzahl der Bytes an, die in den Puffer geschrieben wurden, den Media Foundation beim Aufrufen von BeginReadPayload bereitgestellt hat. Beachten Sie, dass dieser Wert immer der Größe des puffers entsprechen muss, der in BeginReadPayload angegeben ist, es sei denn, die Anforderung ist fehlgeschlagen, oder es sei denn, das Ende des Nachrichtentexts wurde erreicht.

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
 Daten wurden erfolgreich in den Puffer geschrieben, der in BeginReadPayload bereitgestellt wird.

Anforderungen

Anforderung Wert
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