Metodo Media.getMarkerName

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stata sostituita da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer anziché Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il metodo getMarkerName recupera il nome del marcatore nell'indice specificato.

Sintassi

strRetVal = Media.getMarkerName(
  markerNum
)

Parametri

markerNum [in]

Numero (lungo) che specifica un indice di marcatore.

Valore restituito

Questo metodo restituisce un valore String.

Commenti

Questo metodo restituisce NULL se l'indicatore specificato non esiste.

Alcuni elementi multimediali digitali non contengono marcatori. Usare markerCount per scoprire quanti marcatori si trovano nella clip corrente.

I numeri di indice marcatori iniziano a 1.

Per usare questo metodo, è necessario accedere in lettura alla libreria. Per altre informazioni, vedere Accesso alla libreria.

Esempio

L'esempio JScript seguente usa Media. getMarkerName per compilare un elemento TEXTAREA HTML denominato MNAMES con i nomi dei marcatori nell'elemento multimediale corrente. L'oggetto Player è stato creato con ID = "Player".

// 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";
}

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows versione 7.0 o successiva.
DLL	Wmp.dll

Vedi anche

Oggetto Media

Media.getMarkerTime

Media.markerCount

Settings.mediaAccessRights

Settings.requestMediaAccessRights