Download del contenuto multimediale

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stato sostituito da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer invece di Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Lettore multimediale Windows gestisce i download di file musicali per lo store online. Un download può essere avviato quando la pagina di individuazione chiama External.download o quando l'utente sceglie, in Player, per scaricare un set di tracce. In entrambi i casi, Lettore multimediale Windows chiama IWMPContentPartner::D ownload, passando un elenco di contenitori di contenuto che descrive il set di tracce da scaricare e un cookie che rappresenta la transazione di download. Il plug-in partner del contenuto deve quindi chiamare IWMPContentPartnerCallback::D ownloadTrack una volta per ogni traccia nel set. Quando il plug-in chiama DownloadTrack, passa un HRESULT nel parametro hrDownload . Se il plug-in passa un codice di operazione riuscita in hrDownload, Lettore multimediale Windows scarica la traccia. Se il plug-in passa un codice di errore in hrDownload, il lettore non scarica la traccia. Per ogni chiamata a Download, il plug-in deve fornire il cookie della transazione e l'ID della traccia in questione. Per le tracce che verranno effettivamente scaricate, il plug-in deve anche fornire l'URL della traccia.

Dopo il download di un file, Lettore multimediale Windows aggiorna automaticamente la libreria in modo da riflettere la musica appena acquistata. Il lettore fornisce informazioni sullo stato per il plug-in sull'operazione di download chiamando IWMPContentPartner::D ownloadTrackComplete. In questo metodo, il lettore fornisce un HRESULT per indicare l'esito positivo o negativo del download, l'ID traccia e la stringa di parametri personalizzata fornita dall'archivio online quando ha chiamato DownloadTrack.

Argomenti correlati

Guida alla programmazione per gli archivi online di tipo 1