Metodo IMFHttpDownloadRequest::GetTotalLength (mfidl.h)

Richiamato da Microsoft Media Foundation per recuperare la lunghezza totale della risorsa scaricata, se nota.

Sintassi

HRESULT GetTotalLength(
  [out] QWORD *pqwTotalLength
);

Parametri

[out] pqwTotalLength

Lunghezza totale, in byte, della risorsa scaricata, se nota. Se non noto, impostare su MAX_ULONG (0xFFFFFFFFFFFFFFFF).

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non solo, quelli nella tabella seguente.

Osservazioni:

Microsoft Media Foundation richiama GetTotalLength solo dopo aver richiamato correttamente EndReceiveResponse. La lunghezza totale della risorsa può essere maggiore della quantità di dati restituiti dal server nella risposta corrente. Ad esempio, se la richiesta include l'intestazione HTTP "Range", i dati restituiti nella risposta potrebbero essere inferiori alla lunghezza totale della risorsa. Il metodo GetRangeEndOffset può essere utilizzato per calcolare la quantità di dati restituiti nella risposta corrente.

Requisiti

Vedere anche

IMFHttpDownloadRequest