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
| Anforderung | Wert |
|---|---|
| Header | strmif.h (include Dshow.h) |