Compartilhar via


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

Invocado pelo Microsoft Media Foundation para concluir a operação assíncrona iniciada pelo BeginReadPayload. Quando esse método for concluído com êxito, os dados de carga terão sido gravados no buffer que o Media Foundation forneceu ao invocar BeginReadPayload.

Sintaxe

HRESULT EndReadPayload(
  [in]  IMFAsyncResult *pResult,
  [out] QWORD          *pqwOffset,
  [out] ULONG          *pcbRead
);

Parâmetros

[in] pResult

Ponteiro para a interface IMFAsyncResult . O Microsoft Media Foundation passará o mesmo ponteiro que seu objeto de retorno de chamada recebeu no método IMFAsyncCallback::Invoke .

[out] pqwOffset

O deslocamento do primeiro byte gravado no buffer, em relação ao corpo completo da mensagem da solicitação HTTP atual. Por exemplo, quando a Media Foundation invoca BeginReadPayload pela primeira vez em um determinado IMFHttpDownloadRequest e especifica um tamanho de buffer de 100, o parâmetro pqwOffset será definido como 0. Em seguida, quando o Media Foundation invocar BeginReadPayload pela segunda vez no mesmo IMNFHttpDownloadRequest, o parâmetro pqwOffset será definido como 100.

[out] pcbRead

Especifica o número de bytes gravados no buffer que a Media Foundation forneceu ao invocar BeginReadPayload. Observe que esse valor sempre deve ser igual ao tamanho do buffer especificado em BeginReadPayload, a menos que a solicitação falhe ou a menos que o final do corpo da mensagem tenha sido atingido.

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
Os dados foram escritos com êxito no buffer fornecido no BeginReadPayload.

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