IMFHttpDownloadRequest::GetTotalLength 메서드(mfidl.h)

Microsoft Media Foundation에서 호출하여 다운로드 중인 리소스의 총 길이(알려진 경우)를 검색합니다.

구문

HRESULT GetTotalLength(
  [out] QWORD *pqwTotalLength
);

매개 변수

[out] pqwTotalLength

알려진 경우 다운로드되는 리소스의 총 길이(바이트)입니다. 알 수 없는 경우 를 MAX_ULONG(0xFFFFFFFFFFFFFFFF )로 설정합니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	Description
S_OK	‘작업이 성공적으로 완료되었습니다.’
E_POINTER	pqwTotalLength 매개 변수가 잘못된 포인터입니다.

설명

Microsoft Media Foundation은 EndReceiveResponse를 성공적으로 호출한 후에만 GetTotalLength를 호출합니다. 리소스의 총 길이는 현재 응답에서 서버가 반환하는 데이터 양보다 클 수 있습니다. 예를 들어 요청에 HTTP "Range" 헤더가 포함된 경우 응답에 반환된 데이터가 리소스의 총 길이보다 작을 수 있습니다. GetRangeEndOffset 메서드를 사용하여 현재 응답에서 반환되는 데이터의 양을 계산할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10, 버전 1703 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	mfidl.h
라이브러리	Mfplat.lib; Mfplat.dll

추가 정보

IMFHttpDownloadRequest