Propriété IWMPControls3::currentPositionTimecode

Article
06/21/2023

[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 obtient ou définit 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.

Syntaxe

public System.String currentPositionTimecode {get; set;}


Public Property currentPositionTimecode As System.String

Valeur de la propriété

System.String qui est le code de temps SMPTE.

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 horaire actuel ou rechercher une image vidéo identifiée par un code horaire particulier.

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 est au format [plage]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 définissez une valeur pour currentPositionTimecode, vous devez inclure les huit chiffres, en utilisant des zéros comme espaces réservés.

[range] 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 définition et l’obtention de currentPositionTimecode sont prises en charge uniquement 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 AxWMPLib.AxWindowsMediaPlayer est représenté par la variable nommée player.

// Cast the interface returned by player.Ctlcontrols to an IWMPControls3 interface
// so that you can use the currentPositionTimecode property.
WMPLib.IWMPControls3 controls = (WMPLib.IWMPControls3)player.Ctlcontrols;

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


' Cast the interface returned by player.Ctlcontrols to an IWMPControls3 interface
&#39; so that you can use the currentPositionTimecode property.
Dim controls As WMPLib.IWMPControls3 = player.Ctlcontrols

&#39; Seek to a frame using SMPTE time code.
Controls.currentPositionTimecode = &quot;[00000]01:00:30.05&quot;

Configuration requise

Condition requise	Valeur
Version	série Lecteur multimédia Windows 9 ou ultérieure
Espace de noms	WMPLib
Assembly	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Voir aussi

IWMPControls3, interface (VB et C#)