REGFILTERPINS2 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 REGFILTERPINS2 structure contains information for registering a filter through the IFilterMapper2 interface.

Syntax

typedef struct REGFILTERPINS2 {
  DWORD              dwFlags;
  UINT               cInstances;
  UINT               nMediaTypes;
  const REGPINTYPES  *lpMediaType;
  UINT               nMediums;
  const REGPINMEDIUM *lpMedium;
  const CLSID        *clsPinCategory;
} REGFILTERPINS2;

Members

dwFlags

Bitwise combination of zero or more REG_PINFLAG flags.

cInstances

Number of instances of this pin.

nMediaTypes

Number of media types supported by this pin.

lpMediaType

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

nMediums

Number of mediums. Can be zero.

lpMedium

Pointer to an array of REGPINMEDIUM structures, of size nMediums.

clsPinCategory

Optional pin category, from the Pin Property Set.

Remarks

If you use this structure, set the dwVersion member of the REGFILTER2 structure to 2.

Requirements

Requirement	Value
Header	strmif.h (include Dshow.h)

See also

DirectShow Structures