REGFILTER2 Structure

The REGFILTER2 structure contains information for registering a filter.

Syntax

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

Members

dwVersion

Filter registration format. If the value is 1, the union contains the first unnamed structure. If the value is 2, the union contains the second unnamed structure.

dwMerit

Filter merit. Filters with higher merit are enumerated first. See Merit.

cPins

Number of pins. (Defined only if dwVersion is 1.)

rgPins

Pointer to an array of REGFILTERPINS structures, of size cPins. (Defined only if dwVersion is 1.)

cPins2

Number of pins. (Defined only if dwVersion is 2.)

rgPins2

Pointer to an array of REGFILTERPINS2 structures, of size cPins2. (Defined only if dwVersion is 2.)

Remarks

This structure is passed to the IFilterMapper2::RegisterFilter method.

If you need to register pin mediums or pin categories, set dwVersion to 2 and use the REGFILTERPINS2 structure.

See Also

• DirectShow Structures