Partager via


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

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