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

Invocado por Microsoft Media Foundation para recuperar la longitud total del recurso que se está descargando, si se conoce.

Sintaxis

HRESULT GetTotalLength(
  [out] QWORD *pqwTotalLength
);

Parámetros

[out] pqwTotalLength

Longitud total, en bytes, del recurso que se está descargando, si se conoce. Si no se conoce, establezca en MAX_ULONG (0xFFFFFFFFFFFFFFFF).

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	La operación se completó correctamente.
E_POINTER	El parámetro pqwTotalLength es un puntero no válido.

Comentarios

Microsoft Media Foundation invoca GetTotalLength solo después de haber invocado correctamente EndReceiveResponse. La longitud total del recurso puede ser mayor que la cantidad de datos devueltos por el servidor en la respuesta actual. Por ejemplo, si la solicitud incluía el encabezado HTTP "Range", los datos devueltos en la respuesta pueden ser menores que la longitud total del recurso. El método GetRangeEndOffset se puede usar para calcular la cantidad de datos que se devuelven en la respuesta actual.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1703 [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	mfidl.h
Library	Mfplat.lib; Mfplat.dll

Consulte también

IMFHttpDownloadRequest