METODE IMFHttpDownloadRequest::GetTotalLength (mfidl.h)

Dipanggil oleh Microsoft Media Foundation untuk mengambil total panjang sumber daya yang sedang diunduh, jika diketahui.

Sintaks

HRESULT GetTotalLength(
  [out] QWORD *pqwTotalLength
);

Parameter

[out] pqwTotalLength

Panjang total, dalam byte, dari sumber daya yang diunduh, jika diketahui. Jika tidak diketahui, atur ke MAX_ULONG (0xFFFFFFFFFFFFFFFF).

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Berhasil menyelesaikan operasi.
E_POINTER	Parameter pqwTotalLength adalah penunjuk yang tidak valid.

Keterangan

Microsoft Media Foundation memanggil GetTotalLength hanya setelah berhasil memanggil EndReceiveResponse. Panjang total sumber daya mungkin lebih besar dari jumlah data yang dikembalikan oleh server dalam respons saat ini. Misalnya, jika permintaan menyertakan header "Rentang" HTTP, data yang dikembalikan dalam respons mungkin kurang dari total panjang sumber daya. Metode GetRangeEndOffset dapat digunakan untuk menghitung berapa banyak data yang dikembalikan dalam respons saat ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1703 [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	mfidl.h
Pustaka	Mfplat.lib; Mfplat.dll

Lihat juga

IMFHttpDownloadRequest