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 Writerersetzt. Source Reader und Sink Writer wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code Source Reader und Sink Writer- anstelle Windows Media Format 11 SDK-verwendet werden soll. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, um die neuen APIs zu verwenden, falls möglich umgeschrieben 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 die COM-Funktion CoCreateInstancemanuell zu verwenden.
Einige Schnittstellen haben eine Nummer an ihre Namen angefügt, 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 COM-Hauptobjekt enthalten sind, zuerst aufgeführt, gefolgt von Rückrufschnittstellen, die von der Anwendung implementiert werden müssen.
In der folgenden Tabelle sind die objekte aufgeführt, die von diesem SDK unterstützt werden, wobei eine Beschreibung der Funktionalität der einzelnen Und die zum Erstellen verwendete Funktion aufgeführt ist.
| Objekt | Beschreibung | Erstellungsfunktion |
|---|---|---|
| Backup Restorer | 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 Mediendaten, die DRM-geschützt sind, 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 die Lizenzsperrung. | WMCreateLicenseRevocationAgent- |
| Metadaten-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 |
| Reader- | Liest ASF-Dateien. Dieses Objekt verwendet ein asynchrones Aufrufmodell für seine Vorgänge. | WMCreateReader- |
| Synchronleser- | Liest ASF-Dateien mithilfe synchroner Aufrufe. | WMCreateSyncReader- |
| Writer | Schreibt ASF-Dateien. | WMCreateWriter- |
| Writer File Sink | Steuert ASF-Dateien, die vom Writer-Objekt geschrieben wurden. | WMCreateWriterFileSink |
| Writer Network Sink | Steuert das Livenetzwerkstreaming von ASF-Dateien, die vom Writer-Objekt geschrieben wurden. | WMCreateWriterNetworkSink |
| Writer Push Sink | 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 durch Methoden vorhandener Objekte erstellt.
| Objekt | Beschreibung | Erstellungsmethode |
|---|---|---|
| Bandbreitenfreigabe- | Verwaltet Bandbreitenfreigabeinformationen in einem Profil. Für ein Profil können mehrere Bandbreitenfreigabeobjekten 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::CreateNewBandwidthSharingOR IWMProfile3::GetBandwidthSharing |
| Puffer- | Enthält ein Medienbeispiel und alle zugehörigen Dateneinheitserweiterungen. Wird sowohl für Schreib- als auch für Lesebeispiele verwendet. |
IWMWriter::AllocateSampleOR IWMReaderAllocatorEx::AllocateForOutputEx- ODER IWMReaderAllocatorEx::AllocateForStreamEx- ODER Wird automatisch vom Leseobjekt oder synchronen Leseobjekt für die Beispielübermittlung erstellt. |
| Eingabemedieneigenschaften | Verwaltet die Eigenschaften einer Eingabe. Für jede Eingabe kann ein Eingabeeigenschaftenobjekt vorhanden sein. | IWMWriter::GetInputProps |
| gegenseitigen Ausschluss | Verwaltet gegenseitige Ausschlussinformationen in einem Profil. Häufige Verwendungsmöglichkeiten für den gegenseitigen Ausschluss sind mehrere Bitrateninhalte und Soundtracks in mehreren Sprachen. Es gibt verschiedene Methoden zum Erstellen eines gegenseitigen Ausschlussobjekts, je nachdem, ob Sie ein neues gegenseitiges Ausschlussobjekt erstellen oder auf ein vorhandenes Objekt zugreifen möchten. |
IWMProfile::CreateNewMutualExclusionOR IWMProfile::GetMutualExclusion |
| Ausgabemedieneigenschaften | Verwaltet die Eigenschaften einer Ausgabe. Ein Ausgabemedieneigenschaftenobjekt kann für jede Ausgabe vorhanden sein. Diese Objekte können vom Leser oder vom synchronen Reader erstellt werden. |
IWMReader::GetOutputPropsOR 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::CreateEmptyProfileOR IWMProfileManager::LoadProfileByData ODER IWMProfileManager::LoadProfileByID ODER IWMProfileManager::LoadSystemProfile |
| Streamkonfiguration | Verwaltet die Eigenschaften eines Datenstroms innerhalb eines Profils. Streamkonfigurationsobjekte werden von Streamobjekten jederzeit erstellt, wenn Sie auf die Informationen zu einem Datenstrom zugreifen müssen. Es gibt unterschiedliche Methoden zum Erstellen eines Datenstromkonfigurationsobjekts, je nachdem, ob Sie einen neuen Datenstrom oder Zugriff und einen vorhandenen datenstrom erstellen möchten. |
IWMProfile::CreateNewStreamOR IWMProfile::GetStream ODER IWMProfile::GetStreamByNumber |
| StreamPriorisierung | Verwaltet die Datenstromprioritätsliste für ein Profil. Die Datenströme werden gelöscht, um die Priorität zu erhöhen, wenn die verfügbare Bandbreite eingeschränkt ist. Es kann nur ein Datenstrompriorisierungsobjekt in einem Profil vorhanden sein. | IWMProfile3::CreateNewStreamPrioritization |