IMFHttpDownloadRequest-Schnittstelle (mfidl.h)
Anwendungen implementieren diese Schnittstelle, um die Standardimplementierung der von Microsoft Media Foundation verwendeten HTTP- und HTTPS-Protokolle außer Kraft zu setzen. Anwendungen stellen die IMFHttpDownloadRequest-Schnittstelle für Media Foundation über die CreateRequest-Methode auf der IMFHttpDownloadSession-Schnittstelle bereit.
Vererbung
Die IMFHttpDownloadRequest-Schnittstelle erbt von der IUnknown-Schnittstelle . IMFHttpDownloadRequest verfügt auch über folgende Membertypen:
Methoden
Die IMFHttpDownloadRequest-Schnittstelle verfügt über diese Methoden.
| IMFHttpDownloadRequest::AddHeader Wird von Microsoft Media Foundation aufgerufen, um einer HTTP-Anforderung einen einzelnen HTTP-Header hinzuzufügen. Microsoft Media Foundation ruft diese Methode einmal für jeden Header auf, der in der HTTP-Anforderung enthalten sein soll, bevor die BeginSendRequest-Methode aufgerufen wird. |
| IMFHttpDownloadRequest::BeginReadPayload Wird von Microsoft Media Foundation aufgerufen, um den Nachrichtentext der Antwort auf eine zuvor gesendete HTTP- oder HTTPS-Anforderung zu empfangen. |
| IMFHttpDownloadRequest::BeginReceiveResponse Wird von Microsoft Media Foundation aufgerufen, um die vom Server bereitgestellte Antwort als Reaktion auf eine zuvor gesendete HTTP- oder HTTPS-Anforderung zu erhalten. Media Foundation ruft diese Methode erst auf, nachdem die EndSendRequest-Methode erfolgreich aufgerufen wurde. |
| IMFHttpDownloadRequest::BeginSendRequest Wird von Microsoft Media Foundation aufgerufen, um eine HTTP- oder HTTPS-Anforderung zu senden. |
| IMFHttpDownloadRequest::Close Wird von Microsoft Media Foundation aufgerufen, damit IMFHttpDownloadRequest interne Ressourcen freigeben können. Außerdem wird die aktuelle Anforderung abgebrochen, wenn sie noch ausgeführt wird. |
| IMFHttpDownloadRequest::EndReadPayload Wird von Microsoft Media Foundation aufgerufen, um den asynchronen Vorgang abzuschließen, der von BeginReadPayload gestartet wurde. |
| IMFHttpDownloadRequest::EndReceiveResponse Wird von Microsoft Media Foundation aufgerufen, um den asynchronen Vorgang abzuschließen, der von BeginReceiveResponse gestartet wurde. |
| IMFHttpDownloadRequest::EndSendRequest Wird von Microsoft Media Foundation aufgerufen, um den asynchronen Vorgang abzuschließen, der von BeginSendRequest gestartet wurde. |
| IMFHttpDownloadRequest::GetAtEndOfPayload Wird von Microsoft Media Foundation aufgerufen, um zu überprüfen, ob BeginReadPayload aufgerufen werden soll, um Daten aus dem Nachrichtentext der Antwort zu lesen. |
| IMFHttpDownloadRequest::GetHttpStatus Wird von Microsoft Media Foundation aufgerufen, um den HTTP-status Code abzurufen, den der Server in seiner Antwort angegeben hat. Media Foundation ruft diese Methode nach einem erfolgreichen Aufruf von EndReceiveResponse auf. |
| IMFHttpDownloadRequest::GetRangeEndOffset Wird von Microsoft Media Foundation aufgerufen, um den Offset des letzten Byte in der aktuellen Antwort abzurufen, der vom Anfang der Ressource gezählt wird. Dies ist nützlich, wenn eine Anforderung den HTTP-Header "Range" verwendet, um nur einen Teil einer Ressource herunterzuladen. |
| IMFHttpDownloadRequest::GetTimeSeekResult Wird von Microsoft Media Foundation aufgerufen, um die Werte des TimeSeekRange.DLNA.ORG HTTP-Headers abzurufen, sofern vorhanden, den der Server in seiner Antwort angegeben hat. |
| IMFHttpDownloadRequest::GetTotalLength Wird von Microsoft Media Foundation aufgerufen, um die Gesamtlänge der heruntergeladenen Ressource abzurufen, sofern bekannt. |
| IMFHttpDownloadRequest::GetURL Gibt die URL zurück, die zum Senden der Anforderung verwendet wird. |
| IMFHttpDownloadRequest::HasNullSourceOrigin Wird von Microsoft Media Foundation aufgerufen, um den Fall zu erkennen, wenn eine HTTP- oder HTTPS-Anforderung an einen anderen Server mit unterschiedlichem "Ursprung" umgeleitet wurde. |
| IMFHttpDownloadRequest::QueryHeader Wird von Microsoft Media Foundation aufgerufen, um die Werte der angegebenen HTTP-Header aus der Antwort auf eine zuvor gesendete HTTP- oder HTTPS-Anforderung abzurufen. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1703 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | mfidl.h |