IMFHttpDownloadRequest 인터페이스(mfidl.h)

애플리케이션은 이 인터페이스를 구현하여 Microsoft Media Foundation에서 사용하는 HTTP 및 HTTPS 프로토콜의 기본 구현을 재정의합니다. 애플리케이션은 IMFHttpDownloadSession 인터페이스의 CreateRequest 메서드를 통해 MEDIA Foundation에 IMFHttpDownloadRequest 인터페이스를 제공합니다.

상속

IMFHttpDownloadRequest 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IMFHttpDownloadRequest 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IMFHttpDownloadRequest 인터페이스에는 이러한 메서드가 있습니다.

IMFHttpDownloadRequest::AddHeader 단일 HTTP 헤더를 HTTP 요청에 추가하기 위해 Microsoft Media Foundation에서 호출합니다. Microsoft Media Foundation은 BEGINSendRequest 메서드를 호출하기 전에 HTTP 요청에 포함해야 하는 각 헤더에 대해 이 메서드를 한 번 호출합니다.
IMFHttpDownloadRequest::BeginReadPayload 이전에 보낸 HTTP 또는 HTTPS 요청에 대한 응답의 메시지 본문을 수신하기 위해 Microsoft Media Foundation에서 호출합니다.
IMFHttpDownloadRequest::BeginReceiveResponse 이전에 보낸 HTTP 또는 HTTPS 요청에 대한 응답으로 서버에서 제공하는 응답을 받기 위해 Microsoft Media Foundation에서 호출합니다. Media Foundation은 EndSendRequest 메서드를 성공적으로 호출한 후에만 이 메서드를 호출합니다.
IMFHttpDownloadRequest::BeginSendRequest Http 또는 HTTPS 요청을 보내기 위해 Microsoft Media Foundation에서 호출합니다.
IMFHttpDownloadRequest::Close IMFHttpDownloadRequest가 내부 리소스를 해제할 수 있도록 Microsoft Media Foundation에서 호출합니다. 또한 아직 진행 중인 경우 현재 요청을 취소합니다.
IMFHttpDownloadRequest::EndReadPayload BeginReadPayload에서 시작된 비동기 작업을 완료하기 위해 Microsoft Media Foundation에서 호출합니다.
IMFHttpDownloadRequest::EndReceiveResponse BeginReceiveResponse에서 시작된 비동기 작업을 완료하기 위해 Microsoft Media Foundation에서 호출합니다.
IMFHttpDownloadRequest::EndSendRequest BeginSendRequest에서 시작된 비동기 작업을 완료하기 위해 Microsoft Media Foundation에서 호출합니다.
IMFHttpDownloadRequest::GetAtEndOfPayload Microsoft Media Foundation에서 호출하여 BeginReadPayload를 호출하여 응답의 메시지 본문에서 데이터를 읽어야 하는지 검사.
IMFHttpDownloadRequest::GetHttpStatus Microsoft Media Foundation에서 호출하여 서버가 응답에 지정한 HTTP 상태 코드를 검색합니다. Media Foundation은 EndReceiveResponse를 성공적으로 호출한 후 이 메서드를 호출합니다.
IMFHttpDownloadRequest::GetRangeEndOffset 리소스 시작부터 계산된 현재 응답에서 마지막 바이트의 오프셋을 검색하기 위해 Microsoft Media Foundation에서 호출합니다. 이는 요청이 HTTP "범위" 헤더를 사용하여 리소스의 일부만 다운로드하는 경우에 유용합니다.
IMFHttpDownloadRequest::GetTimeSeekResult Microsoft Media Foundation에서 호출하여 서버가 응답에 지정한 TimeSeekRange.DLNA.ORG HTTP 헤더(있는 경우)의 값을 검색합니다.
IMFHttpDownloadRequest::GetTotalLength Microsoft Media Foundation에서 호출하여 다운로드 중인 리소스의 총 길이(알려진 경우)를 검색합니다.
IMFHttpDownloadRequest::GetURL 요청을 보내는 데 사용되는 URL을 반환합니다.
IMFHttpDownloadRequest::HasNullSourceOrigin HTTP 또는 HTTPS 요청이 다른 "원본"의 다른 서버로 리디렉션된 경우를 감지하기 위해 Microsoft Media Foundation에서 호출합니다.
IMFHttpDownloadRequest::QueryHeader 이전에 보낸 HTTP 또는 HTTPS 요청에 대한 응답에서 지정된 HTTP 헤더의 값을 검색하기 위해 Microsoft Media Foundation에서 호출합니다.

요구 사항

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