Profile-Objekt
[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.]
Ein Profilobjekt verwaltet die Einstellungen eines Profils. Profilobjekte können für vorhandene Profildaten erstellt werden oder leer erstellt werden, um neue Daten zu empfangen. Ein Profilobjekt wird auch vom Leseobjekt (und dem synchronen Leseobjekt) erstellt, wenn eine Datei zum Lesen geladen wird. In diesem Fall wird das Objekt mit den Profilinformationen gefüllt, die in der Kopfzeile der Datei gespeichert sind.
Um den Inhalt eines Profilobjekts zu speichern, müssen Sie IWMProfileManager::SaveProfileaufrufen.
Ein Profil enthält mehrere Objekte, die verschiedene Aspekte des Profils steuern (z. B. Datenströme). 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.
Rufen Sie zum Erstellen eines Profilobjekts eine der folgenden Methoden auf.
| Methode | Beschreibung |
|---|---|
| IWMProfileManager::CreateEmptyProfile | Erstellt ein Profilobjekt ohne Profildaten. |
| IWMProfileManager::LoadProfileByData | Erstellt ein Profilobjekt, das mit Daten aus einem Profil aufgefüllt wird, das als Zeichenfolge gespeichert wurde. Dies ist die einzige Möglichkeit, ein Profilobjekt mit Daten aus einem benutzerdefinierten Profil zu erstellen. |
| IWMProfileManager::LoadProfileByID | Erstellt ein Profilobjekt, das mit Daten aus einem Systemprofil aufgefüllt wird. Verwendet die GUID, um das gewünschte Systemprofil zu identifizieren. |
| IWMProfileManager::LoadSystemProfile | Erstellt ein Profilobjekt, das mit Daten aus einem Systemprofil aufgefüllt wird. 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 von 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 die GUID (Globally Unique Identifier) ab, die dem Profil zugeordnet ist. Erbt alle Methoden von IWMProfile. |
| IWMProfile3- | Steuert die Bandbreitenfreigabe und Datenstrompriorisierungsinformationen in einem Profil. Erbt alle Methoden von IWMProfile und IWMProfile2. |
Verwandte Themen