Compartilhar via

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

  • Artigo

Invocado pelo Microsoft Media Foundation para enviar uma solicitação HTTP ou HTTPS

Sintaxe

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

Parâmetros

[in] pbPayload

Ponteiro para um buffer que contém o conteúdo da mensagem a ser enviado na solicitação. Esse parâmetro é usado para solicitações POST. As solicitações GET não carregam um conteúdo de mensagem e, portanto, pbPayload é NULL.

[in] cbPayload

O tamanho do buffer pbPayload , em bytes.

[in] pCallback

Ponteiro para a interface IMFAsyncCallback de um objeto de retorno de chamada implementado pelo Microsoft Media Foundation.

punkState

Ponteiro para a interface IUnknown de um objeto de estado, definido pelo Microsoft Media Foundation. Este parâmetro pode ser NULL.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
 Iniciou com êxito a operação assíncrona.
E_OUTOFMEMORY
 Não há memória suficiente para concluir a operação.

Comentários

A implementação do BeginWrite não precisa fazer uma cópia privada da memória apontada por pbPayload, pois o Microsoft Media Foundation não realocará, liberará ou gravará no buffer enquanto uma gravação assíncrona ainda estiver pendente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1703 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho mfidl.h
Biblioteca Mfplat.lib; Mfplat.dll

Confira também

IMFHttpDownloadRequest