REGFILTER2

  • Article

This structure describes a filter for registration through the IFilterMapper2 interface.

typedef struct
{
  DWORD dwVersion;
  DWORD dwMerit;

  /* unnamed union */
  [switch_is(dwVersion)] [switch_type(DWORD)] union
  {
  [case(1)]

  struct
  {
  ULONG cPins;
  [size_is(cPins)] const REGFILTERPINS *rgPins;
  };

  [case(2)]

  struct
  {
  ULONG cPins2;
  [size_is(cPins2)] const REGFILTERPINS2 *rgPins2;
  };
  [default]
  ;
  } ;
} REGFILTER2;

Members

  • dwVersion
    Indicates the filter registration format to use.
  • dwMerit
    Position in the order of enumeration. Filters or categories with higher merit are enumerated first.
  • cPins
    Number of pins (if dwVersion = 1).
  • rgPins
    Array of REGFILTERPINS representing each pin to be registered (if dwVersion = 1).
  • cPins2
    Number of pins (if dwVersion = 2).
  • rgPins2
    Array of REGFILTERPINS2 representing each pin to be registered (if dwVersion = 2).

Remarks

This structure is passed in to the IFilterMapper2::RegisterFilter method.

Set dwVersion to 1 if you are using the old format, or to 2 if you need mediums and pin categories.

Requirements

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header: Dshow.h.

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.