IMFASFContentInfo::GetProfile メソッド (wmcontainer.h)

ASF コンテンツを記述する Advanced Systems Format (ASF) プロファイルを取得します。

構文

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

パラメーター

[out] ppIProfile

IMFASFProfile インターフェイス ポインターを受け取ります。 呼び出し元はインターフェイスを解放する必要があります。 オブジェクトに ASF プロファイルがない場合、このパラメーターは値 NULL を受け取ります。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード	説明
S_OK	メソッドが成功しました。

解説

プロファイルは、 IMFASFContentInfo::SetProfile または IMFASFContentInfo::P arseHeader を呼び出すことによって設定されます。

このメソッドによって返される ASF プロファイル オブジェクトには、 MF_PD_ASF_xxx 属性は含まれません ( 「プレゼンテーション記述子属性」を参照してください)。 これらの属性を取得するには、次の操作を行います。

1. IMFASFContentInfo::GeneratePresentationDescriptor を呼び出して、ASF プレゼンテーション記述子を取得します。 MF_PD_ASF_xxx属性については、プレゼンテーション記述子に対してクエリを実行できます。
2. (省略可能)。) MFCreateASFProfileFromPresentationDescriptor を呼び出して、プレゼンテーション記述子を ASF プロファイルに変換します。 この関数によって作成されたプロファイル オブジェクトには、 MF_PD_ASF_xxx 属性が含まれています。

ASF プロファイルはファイル エンコード用のテンプレートであり、主に ASF コンテンツを作成するためのものです。 既存の ASF ファイルを読み取る場合は、プレゼンテーション記述子を使用してファイルに関する情報を取得することをお勧めします。 1 つの例外は、プロファイルに、プレゼンテーション記述子から直接公開されない相互排他オブジェクトとストリーム優先度設定オブジェクトが含まれていることです。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	wmcontainer.h
Library	Mfuuid.lib

関連項目

ASF ContentInfo オブジェクト

IMFASFContentInfo

新しい ASF ファイルの ContentInfo オブジェクトの初期化