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

Invocado pelo Microsoft Media Foundation para recuperar o comprimento total do recurso que está sendo baixado, se conhecido.

Sintaxe

HRESULT GetTotalLength(
  [out] QWORD *pqwTotalLength
);

Parâmetros

[out] pqwTotalLength

O comprimento total, em bytes, do recurso que está sendo baixado, se conhecido. Se não for conhecido, defina como MAX_ULONG (0xFFFFFFFFFFFFFFFF).

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	Operação concluída com sucesso.
E_POINTER	O parâmetro pqwTotalLength é um ponteiro inválido.

Comentários

O Microsoft Media Foundation invoca GetTotalLength somente depois de ter invocado Com êxito EndReceiveResponse. O comprimento total do recurso pode ser maior do que a quantidade de dados retornados pelo servidor na resposta atual. Por exemplo, se a solicitação incluiu o cabeçalho HTTP "Range", os dados retornados na resposta podem ser menores que o comprimento total do recurso. O método GetRangeEndOffset pode ser usado para calcular quantos dados são retornados na resposta atual.

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