IMFASFContentInfo::GetProfile-Methode (wmcontainer.h)

  • Artikel

Ruft ein ASF-Profil (Advanced Systems Format) ab, das den ASF-Inhalt beschreibt.

Syntax

HRESULT GetProfile(
  [out] IMFASFProfile **ppIProfile
);

Parameter

[out] ppIProfile

Empfängt einen IMFASFProfile-Schnittstellenzeiger . Der Aufrufer muss die Schnittstelle freigeben. Wenn das Objekt kein ASF-Profil hat, empfängt dieser Parameter den Wert NULL.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.

Hinweise

Das Profil wird festgelegt, indem entweder IMFASFContentInfo::SetProfile oder IMFASFContentInfo::P arseHeader aufgerufen wird.

Das von dieser Methode zurückgegebene ASF-Profilobjekt enthält keine der MF_PD_ASF_xxx-Attribute (siehe Presentation Descriptor Attributes). Gehen Sie wie folgt vor, um diese Attribute abzurufen:

  1. Rufen Sie IMFASFContentInfo::GeneratePresentationDescriptor auf, um den ASF-Präsentationsdeskriptor abzurufen. Sie können den Präsentationsdeskriptor für die MF_PD_ASF_xxx-Attribute abfragen.
  2. (Optional.) Rufen Sie MFCreateASFProfileFromPresentationDescriptor auf, um den Präsentationsdeskriptor in ein ASF-Profil zu konvertieren. Das von dieser Funktion erstellte Profilobjekt enthält die attribute MF_PD_ASF_xxx .
Ein ASF-Profil ist eine Vorlage für die Dateicodierung und dient hauptsächlich zum Erstellen von ASF-Inhalten. Wenn Sie eine vorhandene ASF-Datei lesen, empfiehlt es sich, den Präsentationsdeskriptor zu verwenden, um Informationen zur Datei abzurufen. Eine Ausnahme besteht darin, dass das Profil die Objekte für gegenseitigen Ausschluss und Streampriorisierung enthält, die nicht direkt aus dem Präsentationsdeskriptor verfügbar gemacht werden.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wmcontainer.h
Bibliothek Mfuuid.lib

Weitere Informationen

ASF ContentInfo-Objekt

IMFASFContentInfo

Initialisieren des ContentInfo-Objekts einer neuen ASF-Datei