IMFAttributes::Compare メソッド (mfobjects.h)

このオブジェクトの属性を別のオブジェクトの属性と比較します。

構文

HRESULT Compare(
  [in]  IMFAttributes            *pTheirs,
  [in]  MF_ATTRIBUTES_MATCH_TYPE MatchType,
  [out] BOOL                     *pbResult
);

[in] pTheirs

このオブジェクトと比較するオブジェクトの IMFAttributes インターフェイスへのポインター。

[in] MatchType

比較の種類を指定する MF_ATTRIBUTES_MATCH_TYPE 列挙体のメンバー。

[out] pbResult

ブール値を受け取ります。 2 つの属性セットが MatchType パラメーターで指定された方法で一致する場合、値は TRUE です。それ以外の場合、値は FALSE です。

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

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

pThis が Compare メソッドを呼び出すオブジェクトで、pTheirs が pTheirs パラメーターとして渡されるオブジェクトである場合、次の比較は MatchType によって定義されます。

一致の種類	場合にのみ TRUE を返します。
MF_ATTRIBUTES_MATCH_OUR_ITEMS	pThis 内のすべての属性に対して、同じキーと値を持つ属性が pTheirs に存在します。
MF_ATTRIBUTES_MATCH_THEIR_ITEMS	pTheirs 内のすべての属性に対して、同じキーと値を持つ属性が pThis に存在します。
MF_ATTRIBUTES_MATCH_ALL_ITEMS	キーと値のペアは、両方のオブジェクトで同じです。
MF_ATTRIBUTES_MATCH_INTERSECTION	pThis のキーと pTheirs のキーの積集合を取得します。これらのキーに関連付けられている値は、 pThis と pTheirs の両方で同じです。
MF_ATTRIBUTES_MATCH_SMALLER	属性の数が最も少ないオブジェクトを取得します。そのオブジェクト内のすべての属性に対して、同じキーと値を持つ属性が他のオブジェクトに存在します。

pTheirs パラメーターと pbResult パラメーターは NULL にすることはできません。いずれかのパラメーターが NULL の場合は、アクセス違反が発生します。

このインターフェイスは、Windows Media Format 11 SDK 再頒布可能コンポーネントがインストールされている場合、次のプラットフォームで使用できます。

Windows XP Service Pack 2 (SP2) 以降。
Windows XP Media Center Edition 2005 KB900325 (Windows XP Media Center Edition 2005) とKB925766 (2006 年 10 月 Windows XP Media Center Edition の更新プログラムのロールアップ) がインストールされています。

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	mfobjects.h (Mfidl.h を含む)
Library	Mfuuid.lib