Partilhar via


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

Invocado por 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 detalhada.

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, definido pelo Microsoft Media Foundation. Este parâmetro pode ser NULO.

Valor de retorno

O método retorna umHRESULT . Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
Iniciou com êxito a operação assíncrona.

Observações

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

Requisitos

Requisito Valor
Cliente mínimo suportado Windows 10, versão 1703 [somente aplicativos da área de trabalho]
Servidor mínimo compatível Nenhum compatível
da Plataforma de Destino Windows
Header mfidl.h
Library Mfplat.lib
de DLL Mfplat.dll

Consulte também

IMFHttpDownloadRequest