REGFILTER2 Structure

Describes a filter for registration through the IFilterMapper2 interface.

Syntax

typedef struct
{
    DWORD dwVersion;
    DWORD dwMerit;

    /* unnamed union */
    [switch_is(dwVersion)] [switch_type(DWORD)] union
    {
        [case(1)]

            struct
            {
                ULONG cPins;
                [size_is(cPins)] const REGFILTERPINS *rgPins;
            };

        [case(2)]

            struct
            {
                ULONG cPins2;
                [size_is(cPins2)] const REGFILTERPINS2 *rgPins2;
            };

        [default]
            ;
    };

} REGFILTER2;

Members

dwVersion
Indicates the filter registration format to use.
dwMerit
Position in the order of enumeration. Filters or categories with higher merit are enumerated first.
cPins
Number of pins (if dwVersion = 1).
rgPins
Array of REGFILTERPINS structures representing each pin to be registered (if dwVersion = 1).
cPins2
Number of pins (if dwVersion = 2).
rgPins2
Array of REGFILTERPINS2 structures representing each pin to be registered (if dwVersion = 2).

Remarks

This structure is passed in to the IFilterMapper2::RegisterFilter method.
Set dwVersion to 1 if you are using the old format, or to 2 if you need mediums and pin categories.