REGFILTERPINS Structure

  • Article
 
Microsoft DirectShow 9.0

REGFILTERPINS Structure

The REGFILTERPINS structure contains pin information for registering a filter.

Syntax

typedef struct {
    LPWSTR            strName;
    BOOL              bRendered;
    BOOL              bOutput;
    BOOL              bZero;
    BOOL              bMany;
    const CLSID       *clsConnectsToFilter;
    const WCHAR       *strConnectsToPin;
    UINT              nMediaTypes;
    const REGPINTYPES *lpMediaType;
} REGFILTERPINS;

typedef REGFILTERPINS AMOVIESETUP_PIN, 
    * PAMOVIESETUP_PIN, 
    * LPAMOVIESETUP_PIN;

Members

strName

Name of the pin. (Obsolete.)

bRendered

If TRUE, the filter renders the input from this pin. (Applies only to input pins. For output pins, the value is always FALSE.)

bOutput

If TRUE, this pin is an output pin. Otherwise, the pin is an input pin.

bZero

If TRUE, the filter can have zero instances of this pin.

bMany

If TRUE, the filter can create more than one instance of this type of pin.

clsConnectsToFilter

Class identifier (CLSID) of the filter to which this pin connects. (Obsolete.)

strConnectsToPin

Name of the pin to which this pin connects. (Obsolete.)

nMediaTypes

Number of media types supported by this pin.

lpMediaType

Pointer to an array of REGPINTYPES structures, of size nMediaTypes.

Remarks

This structure is used in the IFilterMapper2 interface for filter registration. If you use this stucture, set the dwVersion member of the REGFILTER2 structure to 1. If you need to register a medium or pin category for the pin, use the REGFILTERPINS2 structure instead. In that case, set the REGFILTER2 structure's dwVersion member to 2.

The equivalent AMOVIESETUP_PIN type is used in class factory templates (CFactoryTemplate).

The strName, clsConnectsToFilter, and strConnectsToPin members are obsolete. Their values are not added to the registry.

For more information, see How to Register DirectShow Filters.

Requirements

Header: Dshow.h.

See Also