REGFILTERPINS-Struktur (strmif.h)

[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 REGFILTERPINS Struktur enthält Anheftungsinformationen zum Registrieren eines Filters.

Syntax

typedef struct REGFILTERPINS {
  LPWSTR            strName;
  BOOL              bRendered;
  BOOL              bOutput;
  BOOL              bZero;
  BOOL              bMany;
  const CLSID       *clsConnectsToFilter;
  const WCHAR       *strConnectsToPin;
  UINT              nMediaTypes;
  const REGPINTYPES *lpMediaType;
} REGFILTERPINS;

Member

strName

Name des Pins. (Veraltet)

bRendered

Bei TRUE rendert der Filter die Eingabe von diesem Pin. (Gilt nur für Eingabepins. Bei Ausgabepins ist der Wert immer FALSE.)

bOutput

Bei TRUE handelt es sich bei diesem Pin um einen Ausgabepin. Andernfalls ist der Pin ein Eingabenadel.

bZero

Bei TRUE kann der Filter 0 Instanzen dieses Pins aufweisen.

bMany

Bei TRUE kann der Filter mehrere instance dieser Art von Pin erstellen.

clsConnectsToFilter

Klassenbezeichner (CLSID) des Filters, mit dem dieser Pin verbunden ist. (Veraltet)

strConnectsToPin

Name des Pins, mit dem dieser Pin verbunden ist. (Veraltet)

nMediaTypes

Anzahl der von dieser Pin unterstützten Medientypen.

lpMediaType

Zeiger auf ein Array von REGPINTYPES-Strukturen der Größe nMediaTypes.

Hinweise

Diese Struktur wird in der IFilterMapper2-Schnittstelle für die Filterregistrierung verwendet. Wenn Sie diese Struktur verwenden, legen Sie den dwVersion-Member der REGFILTER2-Struktur auf 1 fest. Wenn Sie ein Medium oder eine Pinkategorie für den Pin registrieren müssen, verwenden Sie stattdessen die REGFILTERPINS2-Struktur . Legen Sie in diesem Fall den dwVersion-Memberder REGFILTER2-Struktur auf 2 fest.

Der entsprechende AMOVIESETUP_PIN Typs wird in Klassenfactoryvorlagen (CFactoryTemplate) verwendet.

Die Elemente strName, clsConnectsToFilter und strConnectsToPin sind veraltet. Ihre Werte werden der Registrierung nicht hinzugefügt.

Weitere Informationen finden Sie unter Registrieren von DirectShow-Filtern.

Anforderungen

Weitere Informationen

DirectShow-Strukturen