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 |