Méthode IMFHttpDownloadRequest ::BeginSendRequest (mfidl.h)

Article
03/01/2024

Appelé par Microsoft Media Foundation pour envoyer une requête HTTP ou HTTPS

Syntaxe

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

Paramètres

[in] pbPayload

Pointeur vers une mémoire tampon qui contient la charge utile de message à envoyer dans la requête. Ce paramètre est utilisé pour les requêtes POST. Les requêtes GET ne transportent pas de charge utile de message et, par conséquent , pbPayload est NULL.

[in] cbPayload

Taille de la mémoire tampon pbPayload , en octets.

[in] pCallback

Pointeur vers l’interface IMFAsyncCallback d’un objet de rappel implémenté par Microsoft Media Foundation.

punkState

Pointeur vers l’interface IUnknown d’un objet d’état, défini par Microsoft Media Foundation. Ce paramètre peut être NULL.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	L’opération asynchrone a démarré avec succès.
E_OUTOFMEMORY	La mémoire est insuffisante pour terminer l’opération.

Remarques

L’implémentation de BeginWrite n’a pas besoin d’effectuer une copie privée de la mémoire pointée par pbPayload, car Microsoft Media Foundation ne réallouera pas, ne libérera pas ou n’écrira pas dans la mémoire tampon pendant qu’une écriture asynchrone est toujours en attente.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1703 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	mfidl.h
Bibliothèque	Mfplat.lib ; Mfplat.dll

Voir aussi

IMFHttpDownloadRequest

Partager via