reference-Element (veraltet)

  • Artikel

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

In diesem Thema wird ein Feature dokumentiert, das in der aktuellen Version von Windows Media Metafiles nicht mehr verwendet wird.

Das Verweiselement enthält eine Liste von Verweisen auf URLs. Jedes Element in der Liste hat das Format Ref XX = URL, wobei XX eine ganze Zahl und URL die URL einer ASF-Datei (Advanced Systems Format) ist.

Syntax

[reference]
RefXX = URL
RefXX = URL
   
<entity type="hellip"/>

Die durch XX dargestellten ganzen Zahlen müssen in aufsteigender Reihenfolge vorliegen. Das heißt, die ganze Zahl in jeder Zeile muss größer als die ganze Zahl in der vorherigen Zeile sein.

Wenn ein Clientprogramm ein Verweiselement liest, versucht es, eine Verbindung mit der Mediendatei herzustellen, die durch die erste URL in der Liste dargestellt wird. Wenn dies fehlschlägt, versucht das Clientprogramm, eine Verbindung mit der Datei herzustellen, die durch die nächste URL in der Liste dargestellt wird. Das Clientprogramm setzt die Liste fort, bis es eine erfolgreiche Verbindung herstellt oder das Ende der Liste erreicht. Beachten Sie, dass das Clientprogramm bei erfolgreicher Verbindung keine der nachfolgenden URLs in der Liste liest.

Beispielcode

Im folgenden Beispiel versucht das Clientprogramm zunächst, eine Verbindung mit der datei herzustellen, die durch die mms-URL dargestellt wird. Wenn dies fehlschlägt, versucht das Clientprogramm, eine Verbindung mit der von der HTTP-URL dargestellten Datei herzustellen.

[reference]
Ref01 = mms://example.com/MusicFile.wma
Ref02 = https://example.com/MusicFile.wma

Bemerkungen

Das ASF-Dateiformat umfasst eine Vielzahl von Medientypen, einschließlich Audio und Video. ASF-Dateien verwenden auch verschiedene Dateinamenerweiterungen, einschließlich .wma und .wmv.

Die durch XX dargestellten ganzen Zahlen müssen in aufsteigender Reihenfolge vorliegen. Das heißt, die ganze Zahl in jeder Zeile muss größer als die ganze Zahl in der vorherigen Zeile sein.

Wenn ein Clientprogramm ein Verweiselement liest, versucht es, eine Verbindung mit der Mediendatei herzustellen, die durch die erste URL in der Liste dargestellt wird. Wenn dies fehlschlägt, versucht das Clientprogramm, eine Verbindung mit der Datei herzustellen, die durch die nächste URL in der Liste dargestellt wird. Das Clientprogramm setzt die Liste fort, bis es eine erfolgreiche Verbindung herstellt oder das Ende der Liste erreicht. Beachten Sie, dass das Clientprogramm bei erfolgreicher Verbindung keine der nachfolgenden URLs in der Liste liest.

Frühere Versionen von Windows Media-Metadateien (veraltet)