IWMProfile-Schnittstelle
[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.]
Die IWMProfile-Schnittstelle ist die primäre Schnittstelle für ein Profilobjekt . Ein Profilobjekt wird verwendet, um benutzerdefinierte Profile zu konfigurieren. Sie können IWMProfile verwenden, um Streamkonfigurationsobjekte und Gegenseitigkeitsausschlussobjekte zu erstellen, zu löschen oder zu ändern. Sie können auch allgemeine Informationen zum Profil festlegen und abrufen. Um auf alle Features des Profilobjekts zuzugreifen, sollten Sie IWMProfile3 verwenden, das von IWMProfile und IWMProfile2 erbt.
IWMProfile ist auch über das Reader-Objekt zugänglich, wo Sie es verwenden können, um Informationen zu den Datenströmen einer Datei abzurufen, die in den Reader geladen wird. Wenn Sie über den Reader auf IWMProfile zugreifen, können Sie Änderungen am Profil vornehmen, aber keine der Änderungen kann in der Datei gespeichert werden. Es ist oft praktisch, das Profil einer vorhandenen Datei als Grundlage für ein neues Profil zu verwenden. Der synchrone Reader unterstützt IWMProfile auf die gleiche Weise wie der Reader.
Die Profilinformationen, die über den Leser oder synchronen Reader abgerufen werden, stammen nicht aus einer PRX-Datei. Der Leser verwendet die Informationen in der ASF-Datei, um die Streamkonfigurationen zusammenzustellen. Daher sind bestimmte Profilinformationen, wie Name und Beschreibung, nicht über den Leser verfügbar.
Es gibt mehrere Möglichkeiten, einen Zeiger auf eine IWMProfile-Schnittstelle abzurufen. Der Profil-Manager verfügt über Methoden zum Erstellen eines neuen Profils und zum Zugreifen auf vorhandene Profile. Alle diese Methoden legen einen IWMProfile-Zeiger fest. Beim Lesen einer Datei kann ein Zeiger auf IWMProfile abgerufen werden, indem die QueryInterface-Methode einer beliebigen Leserschnittstelle aufgerufen wird. Ebenso kann jede Schnittstelle des synchronen Leserobjekts einen Zeiger mit einem Aufruf von QueryInterfaceIWMProfile3 abrufen.
Members
Die IWMProfile-Schnittstelle erbt von der IUnknown-Schnittstelle . IWMProfile verfügt auch über folgende Arten von Membern:
Methoden
Die IWMProfile-Schnittstelle verfügt über diese Methoden.
| Methode | Beschreibung |
|---|---|
| AddMutualExclusion | Fügt dem Profil ein Objekt für gegenseitigen Ausschluss hinzu. |
| AddStream | Fügt dem Profil einen Stream hinzu. |
| CreateNewMutualExclusion | Erstellt ein Gegenseitiges Ausschlussobjekt für das Profil. |
| CreateNewStream | Erstellt ein Streamkonfigurationsobjekt für das Profil. |
| GetDescription | Ruft die Beschreibung des Profils ab. |
| GetMutualExclusion | Ruft ein Gegenseitiges Ausschlussobjekt aus dem Profil ab. |
| GetMutualExclusionCount | Ruft die Anzahl der Gegenseitigkeitsausschlussobjekte im Profil ab. |
| GetName | Ruft den Namen des Profils ab. |
| Getstream | Ruft einen Stream mithilfe einer Indexnummer aus dem Profil ab. |
| GetStreamByNumber | Ruft einen Stream unter Verwendung der Nummer des Datenstroms aus dem Profil ab. |
| GetStreamCount | Ruft die Anzahl der Streams im Profil ab. |
| Getversion | Ruft die Versionsnummer von Microsoft Windows Media Services im Profil ab. |
| ReconfigStream | Ermöglicht die Aufnahme von Änderungen, die an einer Streamkonfiguration vorgenommen wurden, in das Profil. |
| RemoveMutualExclusion | Entfernt ein Gegenseitiges Ausschlussobjekt aus dem Profil. |
| RemoveStream | Entfernt einen Stream aus dem Profil. |
| RemoveStreamByNumber | Entfernt einen Stream aus dem Profil. |
| SetDescription | Gibt die Beschreibung des Profils an. |
| SetName | Gibt den Namen des Profils an. |
Informationen dazu, welche Schnittstellen mithilfe der QueryInterface-Methode dieser Schnittstelle abgerufen werden können, finden Sie im Thema für das Objekt, für das diese Schnittstelle implementiert ist.