Media.getMarkerName-Methode
[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 getMarkerName-Methode ruft den Namen des Markers am angegebenen Index ab.
Syntax
strRetVal = Media.getMarkerName(
markerNum
)
Parameter
-
markerNum [in]
-
Zahl (lang), die einen Markerindex angibt.
Rückgabewert
Diese Methode gibt einen String-Wert zurück.
Bemerkungen
Diese Methode gibt NULL zurück, wenn der angegebene Marker nicht vorhanden ist.
Einige elemente digitaler Medien enthalten keine Marker. Verwenden Sie markerCount , um herauszufinden, wie viele Marker sich im aktuellen Clip befinden.
Markerindexnummern beginnen bei 1.
Um diese Methode zu verwenden, ist Lesezugriff auf die Bibliothek erforderlich. Weitere Informationen finden Sie unter Bibliothekszugriff.
Beispiele
Im folgenden JScript-Beispiel wird Media verwendet. getMarkerName , um ein HTML-TEXTAREA-Element namens MNAMES mit den Namen der Marker im aktuellen Medienelement zu füllen. Das Player-Objekt wurde mit der ID = "Player" erstellt.
// Get the number of markers in the current media item.
var mcount = Player.currentMedia.markerCount;
// Verify that at least one marker exists in the current media.
if (mcount > 0){
// Loop through the marker list.
for (var i = 1; i < mcount + 1; i++){
// Print the marker name to the text area.
MNAMES.value += Player.currentMedia.getMarkerName(i);
MNAMES.value += "\n";
}
Anforderungen
Anforderung | Wert |
---|---|
Version |
Windows Medienwiedergabe Version 7.0 oder höher. |
DLL |
|
Siehe auch
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für