Herunterladen von Medieninhalten

Windows Media Player verarbeitet Downloads von Musikdatei für den Onlineshop. Ein Download kann initiiert werden, wenn die Ermittlungsseite External.download aufruft oder der Benutzer im Player auswählt, um eine Reihe von Spuren herunterzuladen. In beiden Fällen ruft Windows Media Player IWMPContentPartner::D ownloadauf und überspringt eine Inhaltscontainerliste, die den Satz der herunterzuladenden Spuren beschreibt, und ein Cookie, das die Downloadtransaktion darstellt. Das Inhaltspartner-Plug-In muss dann für jede Spur im Satz einmal IWMPContentPartnerCallback::D ownloadTrack aufrufen. Wenn das Plug-In DownloadTrack aufruft, übergibt es ein HRESULT im parameter hrDownload. Wenn das Plug-In in hrDownload einen Erfolgscode übergibt, Windows Media Player die Spur herunter. Wenn das Plug-In in hrDownload einen Fehlercode übergibt, wird die Spur vom Player nicht heruntergeladen. Für jeden Downloadaufruf muss das Plug-In das Transaktionscookie und die ID der jeweiligen Spur liefern. Für Spuren, die tatsächlich heruntergeladen werden, muss das Plug-In auch die URL der Spur angeben.

Nachdem eine Datei heruntergeladen wurde, Windows Media Player die Bibliothek automatisch entsprechend der neu erworbenen Musik aktualisiert. Der Player stellt dem Plug-In Statusinformationen zum Downloadvorgang bereit, indem er IWMPContentPartner::D ownloadTrackComplete aufruft. Bei dieser Methode stellt der Player ein HRESULT bereit, um den Erfolg oder Fehler des Downloads, die Track-ID und die benutzerdefinierte Parameterzeichenfolge anzugeben, die der Onlineshop beim Aufrufen von DownloadTrack bereitgestellt hat.

Programmierhandbuch für Onlineshops vom Typ 1