Microsoft DirectX 8.0

REGFILTERPINS Structure

Structures

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, 
    * FAR 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.