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 da scaricare, se nota. Se non è noto, impostare su MAX_ULONG (0xFFFFFFFFFFFFFFFF).

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Completata l'operazione.
E_POINTER	Il parametro pqwTotalLength è un puntatore non valido.

Commenti

Microsoft Media Foundation richiama GetTotalLength solo dopo aver richiamato EndReceiveResponse. La lunghezza totale della risorsa può essere maggiore della quantità di dati restituiti dal server nella risposta corrente. Ad esempio, se la richiesta includeva 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

Requisito	Valore
Client minimo supportato	Windows 10 versione 1703 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	mfidl.h
Libreria	Mfplat.lib; Mfplat.dll

Vedi anche

IMFHttpDownloadRequest