Compartilhar via

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

  • Artigo

Invocado pelo Microsoft Media Foundation para receber o corpo da mensagem da resposta a uma solicitação HTTP ou HTTPS enviada anteriormente. O Media Foundation invoca esse método somente depois de ter invocado com êxito o método EndReceiveResponse . Como o tamanho do corpo da mensagem pode ser grande ou desconhecido, a Media Foundation pode invocar esse método várias vezes para recuperar o corpo da mensagem de forma por etapas.

Sintaxe

HRESULT BeginReadPayload(
  [out] BYTE             *pb,
  [in]  ULONG            cb,
  [in]  IMFAsyncCallback *pCallback,
        IUnknown         *punkState
);

Parâmetros

[out] pb

Ponteiro para um buffer que recebe os dados.

[in] cb

Especifica o tamanho do buffer pb , 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, definida pelo Microsoft Media Foundation. Este parâmetro pode ser NULL.

Valor retornado

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
 A operação assíncrona foi iniciada com êxito.

Comentários

O Microsoft Media Foundation nunca invoca BeginReadPayload enquanto uma chamada anterior para BeginReadPayload ainda não foi concluída.

Requisitos

   
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