IMFHttpDownloadRequest::EndReadPayload-Methode (mfidl.h)
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 |
---|---|
|
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 |