Controls.currentPositionTimecode

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

La propriété currentPositionTimecode spécifie ou récupère la position actuelle dans l’élément multimédia actif à l’aide d’un format de code temporel. Cette propriété prend actuellement en charge le code de temps SMPTE.

player.controls.currentPositionTimecode
      

Valeurs possibles

Cette propriété est une chaîne en lecture/écriture.

Notes

Le code temporel SMPTE fournit un moyen standard d’identifier une trame vidéo individuelle, ce qui est utile pour synchroniser la lecture. Si un fichier multimédia numérique prend en charge le code de temps SMPTE, Lecteur multimédia Windows pouvez récupérer les informations de position du code d’heure actuelles ou rechercher une image vidéo identifiée par une chaîne de code d’heure particulière.

Le code de temps SMPTE identifie une image particulière par le nombre d’heures, de minutes, de secondes et d’images qui la séparent d’une trame de référence particulière que l’image désignée comme heure zéro. En règle générale, l’intervalle de temps zéro est le début du fichier et une valeur de code de temps SMPTE particulière représente le temps écoulé depuis le début du fichier.

Le code d’heure String est au format [range]hh:mm:ss. ff où [range] représente la plage, hh représente les heures, mm représente les minutes, ss représente les secondes et ff représente les images. Lorsque vous spécifiez une valeur à l’aide de currentPositionTimecode, vous devez inclure les huit chiffres en utilisant des zéros comme espaces réservés.

Le spécificateur [plage] correspond au membre wRange de la structure de WMT_TIMECODE_EXTENSION_DATA format Windows Media. Pour plus d’informations sur les plages de code de temps, consultez le Kit de développement logiciel (SDK) au format Windows Media.

La spécification et la récupération de currentPositionTimecode sont uniquement prises en charge pour les fichiers qui contiennent des informations de code de temps SMPTE.

Exemples

L’exemple de code suivant spécifie currentPositionTimecode comme 1 heure, zéro minutes, 30 secondes et 5 images. L’objet Player a été créé avec ID = « Player ».

// Seek to a frame using SMPTE time code.
Player.controls.currentPositionTimecode = "[00000]01:00:30.05";

Configuration requise

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

Voir aussi

Controls, objet