Controls.currentPositionTimecode

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von Windows Medienwiedergabe SDK zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die currentPositionTimecode-Eigenschaft gibt die aktuelle Position im aktuellen Medienelement unter Verwendung eines Zeitcodeformats an oder ruft sie ab. Diese Eigenschaft unterstützt derzeit SMPTE-Zeitcode.

player.controls.currentPositionTimecode
      

Mögliche Werte

Diese Eigenschaft ist eine String-Eigenschaft mit Lese-/Schreibzugriff.

Bemerkungen

Der SMPTE-Zeitcode bietet eine Standardmethode zum Identifizieren eines einzelnen Videoframes, was für die Synchronisierung der Wiedergabe nützlich ist. Wenn eine digitale Mediendatei SMPTE-Zeitcode unterstützt, können Windows Medienwiedergabe die aktuellen Zeitcodepositionsinformationen abrufen oder nach einem Videoframe suchen, der durch eine bestimmte Zeitcodezeichenfolge identifiziert wird.

Der SMPTE-Zeitcode identifiziert einen bestimmten Frame anhand der Anzahl von Stunden, Minuten, Sekunden und Frames, die ihn von einem bestimmten Referenzrahmen trennen, der als Zeit null bezeichnet wurde. In der Regel ist der Zeitrahmen null der Start der Datei, und ein bestimmter SMPTE-Zeitcodewert stellt die verstrichene Zeit seit dem Start der Datei dar.

Der Zeitcode String hat das Format [range]hh:mm:ss. ff , wobei [Bereich] den Bereich darstellt, hh für Stunden, mm für Minuten, ss für Sekunden und ff für Frames. Wenn Sie einen Wert mit currentPositionTimecode angeben, müssen Sie alle acht Ziffern mit Nullen als Platzhalter einschließen.

Der [Bereich]-Bezeichner entspricht dem wRange-Element der Windows Media Format-WMT_TIMECODE_EXTENSION_DATA-Struktur . Weitere Informationen zu Zeitcodebereichen finden Sie im Windows Media Format SDK.

Das Angeben und Abrufen von currentPositionTimecode wird nur für Dateien unterstützt, die SMPTE-Zeitcodeinformationen enthalten.

Beispiele

Im folgenden Codebeispiel wird currentPositionTimecode als 1 Stunde, null Minuten, 30 Sekunden und 5 Frames angegeben. Das Player-Objekt wurde mit der ID = "Player" erstellt.

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

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe Serie 9 oder höher.
DLL	Wmp.dll

Siehe auch

Controls-Objekt