IMFHttpDownloadRequest インターフェイス (mfidl.h)

アプリケーションでは、このインターフェイスを実装して、Microsoft Media Foundation で使用される HTTP プロトコルと HTTPS プロトコルの既定の実装をオーバーライドします。 アプリケーションは、IMFHttpDownloadSession インターフェイスの CreateRequest メソッドを使用して、MEDIA Foundation に IMFHttpDownloadRequest インターフェイスを提供します。

継承

IMFHttpDownloadRequest インターフェイスは、IUnknown インターフェイスから継承されます。 IMFHttpDownloadRequest には、次の種類のメンバーもあります。

メソッド

IMFHttpDownloadRequest インターフェイスには、これらのメソッドがあります。

IMFHttpDownloadRequest::AddHeader 1 つの HTTP ヘッダーを HTTP 要求に追加するために Microsoft Media Foundation によって呼び出されます。 Microsoft Media Foundation は、BeginSendRequest メソッドを呼び出す前に、HTTP 要求に含めるヘッダーごとにこのメソッドを 1 回呼び出します。
IMFHttpDownloadRequest::BeginReadPayload Microsoft Media Foundation によって呼び出され、以前に送信された HTTP または HTTPS 要求への応答のメッセージ本文を受信します。
IMFHttpDownloadRequest::BeginReceiveResponse Microsoft Media Foundation によって呼び出され、以前に送信された HTTP または HTTPS 要求に応答して、サーバーによって提供された応答を受信します。 Media Foundation は、EndSendRequest メソッドを正常に呼び出した後にのみ、このメソッドを呼び出します。
IMFHttpDownloadRequest::BeginSendRequest HTTP または HTTPS 要求を送信するために Microsoft Media Foundation によって呼び出されます。
IMFHttpDownloadRequest::Close MICROSOFT Media Foundation によって呼び出され、IMFHttpDownloadRequest が内部リソースを解放できるようにします。 進行中の場合は、現在の要求も取り消されます。
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 "Range" ヘッダーを使用してリソースの一部のみをダウンロードする場合に便利です。
IMFHttpDownloadRequest::GetTimeSeekResult Microsoft Media Foundation によって呼び出され、応答でサーバーが指定した TimeSeekRange.DLNA.ORG HTTP ヘッダーの値 (存在する場合) を取得します。
IMFHttpDownloadRequest::GetTotalLength Microsoft Media Foundation によって呼び出され、ダウンロードされるリソースの合計の長さ (既知の場合) を取得します。
IMFHttpDownloadRequest::GetURL 要求の送信に使用される URL を返します。
IMFHttpDownloadRequest::HasNullSourceOrigin MICROSOFT Media Foundation によって呼び出され、HTTP または HTTPS 要求が異なる "配信元" の別のサーバーにリダイレクトされた場合のケースを検出します。
IMFHttpDownloadRequest::QueryHeader Microsoft Media Foundation によって呼び出され、以前に送信された HTTP または HTTPS 要求への応答から指定された HTTP ヘッダーの値を取得します。

要件

要件	値
サポートされている最小のクライアント	Windows 10、バージョン 1703 [デスクトップ アプリのみ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	mfidl.h