Objekte (Windows Media Format 11 SDK)
[Das dieser Seite zugeordnete Feature Windows Media Format 11 SDK ist ein Legacyfeature. Es wurde von Source Reader und Sink Writer abgelöst. Source Reader und Sink Writer wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit quellleser und Senkenschreiber anstelle des Windows Media Format 11 SDK verwendet. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]
Das Windows Media Format SDK verwendet mehrere Objekte zum Lesen, Schreiben, Bearbeiten und Indizieren von ASF-Dateien sowie zum Erstellen und Bearbeiten von Profilen. Jedes Objekt unterstützt eine Reihe von Schnittstellen. Einige Schnittstellen werden in mehreren Objekten unterstützt. In diesen Fällen werden alle Unterschiede bei der Implementierung im Referenzabschnitt für die Schnittstelle erläutert.
Die Objekte im Windows Media Format SDK sind COM-kompatibel. Um die Entwicklung zu vereinfachen, verfügt jedes Objekt über eine zugeordnete Erstellungsfunktion oder -methode. Sie sollten Objekte mithilfe der Erstellungsfunktion oder -Methode erstellen, anstatt manuell die COM-Funktion CoCreateInstance zu verwenden.
Einige Schnittstellen verfügen über eine Zahl, die an ihren Namen angefügt ist, z. B. IWMProfile2 und IWMWriter3. In jedem Fall erben die nummerierten Versionen alle Methoden der früheren Versionen und fügen neue Funktionen hinzu.
Auf jeder Objektseite dieses Verweises werden die schnittstellen, die im Standard COM-Objekt enthalten sind, zuerst aufgelistet, gefolgt von Rückrufschnittstellen, die von der Anwendung implementiert werden müssen.
In der folgenden Tabelle sind die von diesem SDK unterstützten Objekte mit einer Beschreibung der Funktionalität der einzelnen Und der zum Erstellen verwendeten Funktion aufgeführt.
| Object | Beschreibung | Erstellungsfunktion |
|---|---|---|
| Sicherungswiederherstellung | Sichert Lizenzen in der Regel auf Wechselmedien und stellt diese Lizenzen dann auf einem anderen Computer wieder her. | WMCreateBackupRestorer |
| Geräteregistrierung | Verwaltet die Geräteregistrierungsdatenbank, die Einträge für Medienwiedergabegeräte enthält, die über eine Netzwerkverbindung verfügbar sind. | WMCreateDeviceRegistration |
| DRM-Transcryptor | Konvertiert DRM-geschützte Mediendaten in einen Datenstrom, der an Geräte gesendet werden kann, die das Windows Media DRM 10 for Network Devices-Protokoll verwenden. | WMCreateDRMTranscryptor |
| Indexer | Erstellt einen Index für ASF-Dateien, um die Suche in Dateien mit Videostreams zu ermöglichen. | WMCreateIndexer |
| Lizenzsperr-Agent | Verwaltet den Lizenzsperrungsstatus. | WMCreateLicenseRevocationAgent |
| Metadata Editor | Bearbeitet Metadaten in einem ASF-Dateiheader. | WMCreateEditor |
| Profil-Manager | Stellt Schnittstellen zum Erstellen, Laden und Speichern von Profilen bereit. Zum Schreiben einer ASF-Datei ist ein Profil erforderlich. | WMCreateProfileManager |
| Leser | Liest ASF-Dateien. Dieses Objekt verwendet ein asynchrones Aufrufmodell für seine Vorgänge. | WMCreateReader |
| Synchroner Reader | Liest ASF-Dateien mithilfe synchroner Aufrufe. | WMCreateSyncReader |
| Schriftsteller | Schreibt ASF-Dateien. | WMCreateWriter |
| Writer-Dateisenke | Steuert ASF-Dateien, die vom Writer-Objekt geschrieben wurden. | WMCreateWriterFileSink |
| Writer-Netzwerksenke | Steuert das Livenetzwerkstreaming von ASF-Dateien, die vom Writer-Objekt geschrieben wurden. | WMCreateWriterNetworkSink |
| Writer-Pushsenke | Steuert die Übermittlung von Streaminginhalten an Veröffentlichungsserver. | WMCreateWriterPushSink |
In der folgenden Tabelle sind Objekte aufgeführt, die von anderen Objekten abhängig sind. Diese Objekte werden von Methoden vorhandener Objekte erstellt.
| Object | Beschreibung | Erstellungsmethode |
|---|---|---|
| Bandbreitenfreigabe | Verwaltet Informationen zur Bandbreitenfreigabe in einem Profil. Für ein Profil können mehrere Bandbreitenfreigabeobjekte vorhanden sein. Es gibt verschiedene Methoden zum Erstellen eines Bandbreitenfreigabeobjekts, je nachdem, ob Sie ein neues Bandbreitenfreigabeobjekt erstellen oder auf ein vorhandenes zugreifen möchten. |
IWMProfile3::CreateNewBandwidthSharingODER IWMProfile3::GetBandwidthSharing |
| Buffer | Enthält ein Medienbeispiel und alle zugehörigen Dateneinheitenerweiterungen. Wird sowohl zum Schreiben als auch zum Lesen von Beispielen verwendet. |
IWMWriter::AllocateSampleODER IWMReaderAllocatorEx::AllocateForOutputEx oder IWMReaderAllocatorEx::AllocateForStreamEx oder Wird automatisch vom Reader-Objekt oder synchronen Leserobjekt für die Beispielübermittlung erstellt. |
| Eingabemedieneigenschaften | Verwaltet die Eigenschaften einer Eingabe. Für jede Eingabe kann ein Eingabeeigenschaftenobjekt vorhanden sein. | IWMWriter::GetInputProps |
| Gegenseitiger Ausschluss | Verwaltet Informationen zum gegenseitigen Ausschluss in einem Profil. Häufige Verwendungsmöglichkeiten für den gegenseitigen Ausschluss sind Inhalte mit mehreren Bitraten und Soundtracks in mehreren Sprachen. Es gibt verschiedene Methoden zum Erstellen eines gegenseitigen Ausschlussobjekts, je nachdem, ob Sie ein neues Objekt für gegenseitigen Ausschluss erstellen oder auf ein vorhandenes zugreifen möchten. |
IWMProfile::CreateNewMutualExclusionODER IWMProfile::GetMutualExclusion |
| Ausgabemedieneigenschaften | Verwaltet die Eigenschaften einer Ausgabe. Für jede Ausgabe kann ein Ausgabemedieneigenschaftenobjekt vorhanden sein. Diese Objekte können vom Reader oder vom synchronen Reader erstellt werden. |
IWMReader::GetOutputPropsODER IWMSyncReader::GetOutputProps |
| Profil | Enthält die Daten in einem Profil, während es bearbeitet wird. Profilobjekte werden jedes Mal erstellt, wenn das Profil bearbeitet werden muss. Es gibt verschiedene Methoden zum Erstellen eines Profilobjekts, je nachdem, ob Sie ein neues Profil erstellen oder auf ein vorhandenes zugreifen möchten. |
IWMProfileManager::CreateEmptyProfileODER IWMProfileManager::LoadProfileByData oder IWMProfileManager::LoadProfileByID oder IWMProfileManager::LoadSystemProfile |
| Streamkonfiguration | Verwaltet die Eigenschaften eines Datenstroms innerhalb eines Profils. Streamkonfigurationsobjekte werden von Streamobjekten erstellt, wenn Sie auf die Informationen zu einem Stream zugreifen müssen. Es gibt verschiedene Methoden zum Erstellen eines Streamkonfigurationsobjekts, je nachdem, ob Sie einen neuen Stream erstellen oder auf einen vorhandenen Stream zugreifen möchten. |
IWMProfile::CreateNewStreamODER IWMProfile::GetStream oder IWMProfile::GetStreamByNumber |
| Streampriorisierung | Verwaltet die Streamprioritätsliste für ein Profil. Die Datenströme werden in der Reihenfolge der Erhöhung der Priorität gelöscht, wenn die verfügbare Bandbreite eingeschränkt ist. In einem Profil kann nur ein Streampriorisierungsobjekt vorhanden sein. | IWMProfile3::CreateNewStreamPrioritization |