Profile-Objekt
[Das dieser Seite zugeordnete Feature Windows Media Format 11 SDK ist ein Legacyfeature. Sie wurde durch den Quellleser und den Senkenschreiber ersetzt. Quellleser und Senkenschreiber wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit den Quellleser und senkenden Writer anstelle des Windows Media Format 11 SDK verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
Ein Profilobjekt verwaltet die Einstellungen eines Profils. Profilobjekte können für vorhandene Profildaten erstellt oder leer erstellt werden, um neue Daten zu empfangen. Ein Profilobjekt wird auch vom Reader-Objekt (und dem synchronen Leserobjekt) erstellt, wenn eine Datei zum Lesen geladen wird. In diesem Fall wird das Objekt mit den Profilinformationen aufgefüllt, die im Header der Datei gespeichert sind.
Um den Inhalt eines Profilobjekts zu speichern, müssen Sie IWMProfileManager::SaveProfile aufrufen.
Ein Profil enthält mehrere Objekte, die verschiedene Aspekte des Profils (z. B. Streams) steuern. Alle diese Objekte sind dem Profilobjekt untergeordnet. Sie erstellen diese Objekte nicht mit Erstellungsfunktionen wie bei den Hauptobjekten dieses SDK. Stattdessen enthalten die Schnittstellen des Profilobjekts Methoden, die die untergeordneten Objekte erstellen.
Um ein Profilobjekt zu erstellen, rufen Sie eine der folgenden Methoden auf.
| Methode | BESCHREIBUNG |
|---|---|
| IWMProfileManager::CreateEmptyProfile | Erstellt ein Profilobjekt ohne Profildaten. |
| IWMProfileManager::LoadProfileByData | Erstellt ein Profilobjekt, das mit Daten aus einem als Zeichenfolge gespeicherten Profil aufgefüllt wird. Nur so können Sie ein Profilobjekt mit Daten aus einem benutzerdefinierten Profil erstellen. |
| IWMProfileManager::LoadProfileByID | Erstellt ein Profilobjekt, das mit Daten aus einem Systemprofil aufgefüllt ist. Verwendet die GUID, um das gewünschte Systemprofil zu identifizieren. |
| IWMProfileManager::LoadSystemProfile | Erstellt ein Profilobjekt, das mit Daten aus einem Systemprofil aufgefüllt ist. Verwendet den Profilindex, um das gewünschte Systemprofil zu identifizieren. |
Alle Methoden in der vorherigen Tabelle legen einen Zeiger auf eine IWMProfile-Schnittstelle fest. Die anderen Schnittstellen des Profilobjekts können durch Aufrufen der QueryInterface-Methode abgerufen werden.
Die folgenden Schnittstellen werden von jedem Profilobjekt unterstützt.
| Schnittstelle | BESCHREIBUNG |
|---|---|
| IWMLanguageList | Verwaltet eine Liste der Sprachen, die von einer ASF-Datei unterstützt werden. |
| IWMPacketSize | Steuert die maximale Größe von Paketen in einer Datei. |
| IWMPacketSize2 | Steuert die Mindestgröße von Paketen in einer Datei. Erbt alle Methoden von IWMPacketSize. |
| IWMProfile | Steuert die grundlegenden Einstellungen und Objekte, die in einem Profil enthalten sind. |
| IWMProfile2 | Ruft den globalen eindeutigen Bezeichner (GUID) ab, der dem Profil zugeordnet ist. Erbt alle Methoden von IWMProfile. |
| IWMProfile3 | Steuert die Bandbreitenfreigabe und Streampriorisierungsinformationen in einem Profil. Erbt alle Methoden von IWMProfile und IWMProfile2. |
Zugehörige Themen