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

  • Artículo

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