IMFHttpDownloadRequest::BeginSendRequest-Methode (mfidl.h)

Artikel
03/04/2024

Von Microsoft Media Foundation aufgerufen, um eine HTTP- oder HTTPS-Anforderung zu senden

Syntax

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

Parameter

[in] pbPayload

Zeiger 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, daher ist pbPayload NULL.

[in] cbPayload

Die Größe des pbPayload-Puffers in Bytes.

[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.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang abzuschließen.

Hinweise

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

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

Freigeben über