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 conteúdo serão gravados no buffer fornecido pela Media Foundation ao invocar BeginReadPayload.

Sintaxe

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

Parâmetros

[in] pResult

Ponteiro para a interface IMFAsyncResult . 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 a Media Foundation invoca 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 deve ser sempre igual ao tamanho do buffer especificado no BeginReadPayload, a menos que a solicitação tenha falhado ou a menos que o final do corpo da mensagem tenha sido atingido.

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

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