structure REGFILTER2 (strmif.h)

  • Article

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La REGFILTER2 structure contient des informations pour l’inscription d’un filtre.

Syntaxe

typedef struct REGFILTER2 {
  DWORD dwVersion;
  DWORD dwMerit;
  union {
    struct {
      ULONG               cPins;
      const REGFILTERPINS *rgPins;
    } DUMMYSTRUCTNAME;
    struct {
      ULONG                cPins2;
      const REGFILTERPINS2 *rgPins2;
    } DUMMYSTRUCTNAME2;
  } DUMMYUNIONNAME;
} REGFILTER2;

Membres

dwVersion

Filtrer le format d’inscription. Si la valeur est 1, l’union contient la première structure sans nom. Si la valeur est 2, l’union contient la deuxième structure sans nom.

dwMerit

Filtrer le mérite. Les filtres présentant un mérite plus élevé sont énumérés en premier. Voir Merit.

DUMMYUNIONNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.cPins

DUMMYUNIONNAME.DUMMYSTRUCTNAME.rgPins

DUMMYUNIONNAME.DUMMYSTRUCTNAME2

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.cPins2

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.rgPins2

Remarques

Cette structure est passée à la méthode IFilterMapper2 ::RegisterFilter .

Si vous devez inscrire des supports ou des catégories de broches, définissez dwVersion sur 2 et utilisez la structure REGFILTERPINS2 .

Configuration requise

Condition requise Valeur
En-tête strmif.h (include Dshow.h)

Voir aussi

DirectShow Structures