REGFILTERPINS structure (strmif.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The REGFILTERPINS structure contains pin information for registering a filter.
Syntax
typedef struct REGFILTERPINS {
LPWSTR strName;
BOOL bRendered;
BOOL bOutput;
BOOL bZero;
BOOL bMany;
const CLSID *clsConnectsToFilter;
const WCHAR *strConnectsToPin;
UINT nMediaTypes;
const REGPINTYPES *lpMediaType;
} REGFILTERPINS;
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 structure, 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
| Requirement | Value |
|---|---|
| Header | strmif.h (include Dshow.h) |