ns-strmif-regfilterpins.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NS:strmif.REGFILTERPINS	REGFILTERPINS (strmif.h)	The REGFILTERPINS structure contains pin information for registering a filter.	AMOVIESETUP_PIN AMOVIESETUP_PIN structure [DirectShow] LPAMOVIESETUP_PIN LPAMOVIESETUP_PIN structure pointer [DirectShow] PAMOVIESETUP_PIN PAMOVIESETUP_PIN structure pointer [DirectShow] REGFILTERPINS REGFILTERPINS structure [DirectShow] REGFILTERPINSStructure dshow.regfilterpins strmif/AMOVIESETUP_PIN strmif/LPAMOVIESETUP_PIN strmif/PAMOVIESETUP_PIN strmif/REGFILTERPINS	dshow\regfilterpins.htm	dshow	1da033e1-24c3-46e0-becf-025966e6238f	4/26/2023	AMOVIESETUP_PIN, AMOVIESETUP_PIN structure [DirectShow], LPAMOVIESETUP_PIN, LPAMOVIESETUP_PIN structure pointer [DirectShow], PAMOVIESETUP_PIN, PAMOVIESETUP_PIN structure pointer [DirectShow], REGFILTERPINS, REGFILTERPINS structure [DirectShow], REGFILTERPINSStructure, dshow.regfilterpins, strmif/AMOVIESETUP_PIN, strmif/LPAMOVIESETUP_PIN, strmif/PAMOVIESETUP_PIN, strmif/REGFILTERPINS	strmif.h	Dshow.h	Windows															Windows	REGFILTERPINS		19H1	REGFILTERPINS strmif/REGFILTERPINS	c++	APIRef kbSyntax	HeaderDef	strmif.h	REGFILTERPINS

REGFILTERPINS structure

-description

[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.

-struct-fields

-field strName

Name of the pin. (Obsolete.)

-field bRendered

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

-field bOutput

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

-field bZero

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

-field bMany

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

-field clsConnectsToFilter

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

-field strConnectsToPin

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

-field nMediaTypes

Number of media types supported by this pin.

-field 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.

-see-also

DirectShow Structures