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 methode IMFAsyncCallback::Invoke empfangen hat.

[out] pqwOffset

Der Offset des ersten Byte, das in den Puffer geschrieben wurde, 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 auf demselben IMNFHttpDownloadRequest aufruft, wird der Parameter pqwOffset 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 in BeginReadPayload angegebenen Puffers entspricht, es sei denn, die Anforderung ist fehlgeschlagen, oder es sei denn, das Ende des Nachrichtentexts wurde erreicht.

Zurückgegebener Wert

Die Methode gibt ein HRESULT-zurück. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

Anforderungen

Siehe auch

IMFHttpDownloadRequest-