Freigeben über


IMFHttpDownloadRequest::BeginSendRequest-Methode (mfidl.h)

Aufgerufen von Microsoft Media Foundation zum Senden einer HTTP- oder HTTPS-Anforderung

Syntax

HRESULT BeginSendRequest(
  [in] const BYTE       *pbPayload,
  [in] ULONG            cbPayload,
  [in] IMFAsyncCallback *pCallback,
       IUnknown         *punkState
);

Parameter

[in] pbPayload

Zeigen Sie auf einen Puffer, der die Nachrichtennutzlast enthält, die in der Anforderung gesendet werden soll. Dieser Parameter wird für POST-Anforderungen verwendet. GET-Anforderungen enthalten keine Nachrichtennutzlast und daher ist PbPayload NULL.

[in] cbPayload

Die Größe des PbPayload-Puffers in Byte.

[in] pCallback

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

punkState

Zeigen Sie auf die schnittstelle IUnknown schnittstelle eines Zustandsobjekts, das von Microsoft Media Foundation definiert wird. Dieser Parameter kann NULL sein.

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.

Rückgabecode Beschreibung
S_OK
Der asynchrone Vorgang wurde erfolgreich gestartet.
E_OUTOFMEMORY
Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang abzuschließen.

Bemerkungen

Die Implementierung von BeginWrite muss keine private Kopie des Speichers erstellen, auf den pbPayload verweist, da Microsoft Media Foundation den Puffer nicht neu zugeordnet, frei oder in den Puffer schreibt, während ein asynchroner Schreibvorgang noch aussteht.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 10, Version 1703 [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Nicht unterstützt
Zielplattform Windows
Header mfidl.h
Bibliothek Mfplat.lib
DLL Mfplat.dll

Siehe auch

IMFHttpDownloadRequest-