Méthode DownloadCollection.startDownload

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

Notes

Cette section décrit les fonctionnalités conçues pour être utilisées par les magasins en ligne. L’utilisation de cette fonctionnalité en dehors du contexte d’un magasin en ligne n’est pas prise en charge.

La méthode startDownload met en file d’attente un téléchargement.

Syntaxe

retVal = DownloadCollection.startDownload(
  sourceURL,
  type
)

Paramètres

sourceURL [in]

Chaîne spécifiant l’URL du téléchargement.

type [in]

Chaîne spécifiant le type de téléchargement. Contient l'une des valeurs suivantes :

Valeur	Description
background	(Windows XP et versions ultérieures.) Le téléchargement se produit en tant que processus en arrière-plan lorsque le temps processeur devient disponible. Les états de téléchargement persistent même lorsque Lecteur multimédia Windows ou Windows XP est arrêté.
temps réel	(Tous les systèmes d’exploitation pris en charge.) Le téléchargement se produit en même temps. Aucun état de téléchargement persiste entre les sessions.

Valeur retournée

Cette méthode retourne un objet DownloadItem .

Notes

Lorsqu’un nouveau téléchargement est démarré, le Gestionnaire de téléchargement l’ajoute en tant qu’élément à la collection de téléchargement qui a lancé le téléchargement.

Seuls les formats multimédias numériques suivants peuvent être téléchargés :

• ASF (Advanced Systems Format)
• MP3
• Audio Windows Media (WMA)
• Vidéo Windows Media (WMV)

Le paramètre sourceURL ne prend pas en charge les chaînes encodées en Unicode. Il doit pointer vers du contenu valide. Les redirections ne sont pas prises en charge.

Lorsque vous utilisez Windows XP, les fichiers audio sont automatiquement placés dans les sous-dossiers My Music appropriés en fonction des valeurs de métadonnées au niveau du fichier. Les fichiers vidéo sont placés dans \My Music\download\random number\type, où le nombre aléatoire est une valeur aléatoire générée par Lecteur multimédia Windows pour chaque utilisateur, et le type est « temps réel » ou « background », selon le type de téléchargement.

Lorsque vous utilisez Lecteur multimédia Windows série 9 avec Windows 98 et Windows Millennium Edition (ME), les fichiers audio et vidéo sont placés dans \My Music\download\random number\type, où nombre aléatoire est une valeur aléatoire générée par le Lecteur pour chaque utilisateur, et le type est « temps réel » ou « background », en fonction du type de téléchargement.

Notez que les fichiers peuvent être renommés en fonction des attributs de métadonnées contenus dans le fichier et des règles spécifiées par l’utilisateur dans la boîte de dialogue Options . Les fichiers qui ne contiennent pas de métadonnées, telles que Album ou Artiste, peuvent être déplacés vers des dossiers étiquetés Artiste inconnu ou Album inconnu.

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows série 9 ou ultérieure
DLL	Wmp.dll

Voir aussi

Objet DownloadCollection

DownloadItem, objet