Herunterladen von Medieninhalten

  • Artikel

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von Windows Medienwiedergabe SDK zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Windows Medienwiedergabe verarbeitet Downloads von Musikdateien für den Online-Store. Ein Download kann initiiert werden, wenn die Ermittlungsseite External.download aufruft oder wenn der Benutzer im Player eine Reihe von Spuren herunterladen möchte. In beiden Fällen ruft Windows Medienwiedergabe IWMPContentPartner::D ownload auf und übergibt 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 hrDownload-Parameter . Wenn das Plug-In einen Erfolgreichen Code in hrDownload übergibt, lädt Windows Medienwiedergabe die Spur herunter. Wenn das Plug-In einen Fehlercode in hrDownload übergibt, lädt der Player die Spur nicht herunter. Für jeden Aufruf von Download muss das Plug-In das Transaktionscooky und die ID des betreffenden Titels angeben. Für Tracks, die tatsächlich heruntergeladen werden, muss das Plug-In auch die URL des Titels angeben.

Nachdem eine Datei heruntergeladen wurde, aktualisiert Windows Medienwiedergabe die Bibliothek automatisch, um die neu erworbene Musik widerzuspiegeln. Der Player stellt dem Plug-In status Informationen zum Downloadvorgang bereit, indem IWMPContentPartner::D ownloadTrackComplete aufgerufen wird. In 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 Online-Shop beim Aufrufen von DownloadTrack bereitgestellt hat.

Programmierhandbuch für Typ 1-Onlineshops