REGFILTER2-Struktur (strmif.h)

Artikel
03/02/2024

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die REGFILTER2 -Struktur enthält Informationen zum Registrieren eines Filters.

Syntax

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

Member

dwVersion

Filterregistrierungsformat. Wenn der Wert 1 ist, enthält die Union die erste unbenannte Struktur. Wenn der Wert 2 ist, enthält die Union die zweite unbenannte Struktur.

dwMerit

Filterverdienst. Filter mit höherem Wert werden zuerst aufgelistet. Siehe Verdienst.

DUMMYUNIONNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.cPins

DUMMYUNIONNAME.DUMMYSTRUCTNAME.rgPins

DUMMYUNIONNAME.DUMMYSTRUCTNAME2

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.cPins2

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.rgPins2

Hinweise

Diese Struktur wird an die IFilterMapper2::RegisterFilter-Methode übergeben.

Wenn Sie Pinmedien oder Pinkategorien registrieren müssen, legen Sie dwVersion auf 2 fest, und verwenden Sie die REGFILTERPINS2-Struktur .

Anforderungen

Anforderung	Wert
Header	strmif.h (include Dshow.h)

Weitere Informationen

DirectShow-Strukturen

Freigeben über