REGFILTER2 構造体

REGFILTER2 構造体には、フィルタを登録するための情報が格納される。

構文

typedef struct {
    DWORD dwVersion;
    DWORD dwMerit;
    union
    {
        struct {
            ULONG cPins;
            const REGFILTERPINS *rgPins;
        };
        struct {
            ULONG cPins2;
            const REGFILTERPINS2 *rgPins2;
        };
    };
} REGFILTER2;

メンバ

dwVersion

フィルタ登録のフォーマット。値 1 は、共用体に名前のない 1 番目の構造体が格納されていることを示す。値 2 は、共用体に名前のない 2 番目の構造体が格納されていることを示す。

dwMerit

フィルタのメリット。メリット値が高いフィルタほど先に列挙される。「メリット」を参照すること。

cPins

オブジェクトの数 (dwVersion が 1 の場合にのみ定義される)。

rgPins

REGFILTERPINS 構造体の配列へのポインタ。配列のサイズは cPins (dwVersion が 1 の場合にのみ定義される)。

cPins2

オブジェクトの数 (dwVersion が 2 の場合にのみ定義される)。

rgPins2

REGFILTERPINS2 構造体の配列へのポインタ。配列のサイズは cPins2 (dwVersion が 2 の場合にのみ定義される)。

注意

この構造体は、IFilterMapper2::RegisterFilter メソッドに渡される。

ピンのメディアまたはカテゴリを登録するには、dwVersion に 2 を設定し、REGFILTERPINS2 構造体を使う。

参照