ÉLÉMENT REF

[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.]

L’élément REF spécifie une URL pour le contenu multimédia numérique.

<REF
   HREF = "URL"
>
</REF>

Attributs

HREF (obligatoire)

URL vers n’importe quel élément multimédia pris en charge par Lecteur multimédia Windows.

Éléments parent/enfant

Hierarchy	Éléments
Éléments parents	ENTRÉE
Éléments enfants	DURATION, ENDMARKER, PREVIEWDURATION, STARTMARKER, STARTTIME

Notes

Cet élément spécifie une URL pour un élément de contenu multimédia. L’URL peut pointer vers n’importe quel type de média pris en charge, à l’aide de n’importe quel protocole pris en charge par Lecteur multimédia Windows.

Les types de médias pris en charge incluent les images fixes telles que les images .gif et .jpg et les fichiers Flash avec une extension de nom de fichier .swf. Ces types de médias sont utiles pour inclure du contenu publicitaire dans une playlist. Avec les fichiers image et les fichiers Flash qui sont lues dans une boucle, vous devez également spécifier la durée d’affichage de l’élément multimédia en incluant un élément DURATION dans l’élément REF . Si vous souhaitez qu’une image continue à s’afficher pendant que l’entrée suivante de la playlist est mise en mémoire tampon, incluez un élément PARAM dans l’élément ENTRY , définissez son attribut name sur ShowWhileBuffering et définissez son attribut value sur true.

Pour référencer du contenu sur un CD ou un DVD qui le permet, les protocoles wmpcd et wmpdvd sont fournis. Par exemple, la définition de l’attribut HREF sur « wmpdvd://f/5/3 » permet de lire le chapitre 3 du titre 5 sur un DVD, mais uniquement si le DVD a été créé pour l’autoriser.

Les applications qui ouvrent des médias numériques derrière un pare-feu auront de meilleures performances lors de l’ouverture des éléments multimédias si l’adresse est spécifiée à l’aide du nom du serveur de noms de domaine (DNS) au lieu de l’adresse IP.

L’utilisation la plus courante de cet élément est pour la substitution d’URL. Si Lecteur multimédia Windows ne parvient pas à ouvrir un élément multimédia défini dans un élément REF, il tente l’URL dans l’élément REF suivant. Une fois que Lecteur multimédia Windows ouvre le contenu multimédia à partir d’une URL définie dans l’étendue d’un élément ENTRY, il ignore les balises REF suivantes au sein de cet élément ENTRY. Une fois la lecture du contenu terminée, Lecteur multimédia Windows passe à l’élément ENTRY suivant, le cas échéant.

• Important Une fois que Lecteur multimédia Windows établit une connexion à un élément de contenu référencé, il ignore tous les autres éléments REF de cette ENTRÉE, que la connexion se termine normalement ou anormalement.

Si l’élément multimédia référencé est un fichier image, l’élément DURATION doit être utilisé pour spécifier l’heure d’affichage de l’image.

Remarque

La tentative de lecture d’un média Flash qui inclut le son avec la première image peut produire des résultats inattendus. Vous devez créer du contenu Flash pour lire le son avant la deuxième image.

Exemples

<ASX VERSION="3.0">
   <ENTRY>
   <TITLE>Example Clip</TITLE>
      <REF HREF="mms://example.microsoft.com/selection1.asf" />
      <REF HREF="mms://sample.microsoft.com/mirror/selection1.asf" />
   </ENTRY>
</ASX>

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows version 7.0 ou ultérieure

Voir aussi

Protocoles et types de fichiers pris en charge

Informations de référence sur les éléments de métafichier Windows Media

Informations de référence sur les métafichiers Windows Media