Filterkategorien
[Bei dem dieser Seite zugeordneten Feature DirectShow handelt es sich um ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine sowie der Audio- und Videoaufnahme in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt für neuen Code nach Möglichkeit dringend die Verwendung von MediaPlayer, IMFMediaEngine sowie der Audio- und Videoaufnahme in Media Foundation anstelle von DirectShow. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, wenn möglich umgeschrieben wird, um die neuen APIs zu verwenden.]
In den folgenden Tabellen sind die CLSIDs für die DirectShow-Filterkategorien aufgeführt.
- DirectShow-Filterkategorien
- Andere Filterkategorien
- DirectShow-Filter-Meta-Kategorie
- DMO-Kategorien
- Verwandte Themen
DirectShow-Filterkategorien
Die hier aufgeführten Kategorien werden vom Filter Mapper aufgelistet. Standardmäßig ignoriert der Filter Mapper jedoch Kategorien mit dem Wert MERIT_DO_NOT_USE oder weniger. Weitere Informationen finden Sie unter IFilterMapper2::EnumMatchingFilters. Alle hier aufgeführten Kategorien können auch mit dem System Device Enumerator aufgelistet werden.
Die folgenden Kategorien sind in Uuids.h deklariert. Binden Sie die Header-Datei Dshow.h ein.
| Anzeigename | CLSID | Verdienst |
|---|---|---|
| Audio Capture Sources | CLSID_AudioInputDeviceCategory | MERIT_DO_NOT_USE |
| Audio Compressors | CLSID_AudioCompressorCategory | MERIT_DO_NOT_USE |
| Audio Renderers | CLSID_AudioRendererCategory | MERIT_NORMAL |
| Device Control Filters | CLSID_DeviceControlCategory | MERIT_DO_NOT_USE |
| DirectShow Filters | CLSID_LegacyAmFilterCategory | MERIT_NORMAL |
| External Renderers | CLSID_TransmitCategory | MERIT_DO_NOT_USE |
| Midi Renderers | CLSID_MidiRendererCategory | MERIT_NORMAL |
| Video Capture Sources | CLSID_VideoInputDeviceCategory | MERIT_DO_NOT_USE |
| Video Compressors | CLSID_VideoCompressorCategory | MERIT_DO_NOT_USE |
| WDM Stream Decompression Devices | CLSID_DVDHWDecodersCategory Hinweis: Diese Kategorie enthält Hardware-DVD-Decoder. |
MERIT_DO_NOT_USE |
| WDM Streaming Capture Devices | AM_KSCATEGORY_CAPTURE | MERIT_DO_NOT_USE |
| WDM Streaming Crossbar Devices | AM_KSCATEGORY_CROSSBAR | MERIT_DO_NOT_USE |
| WDM Streaming Rendering Devices | AM_KSCATEGORY_RENDER | MERIT_DO_NOT_USE |
| WDM Streaming Tee/Splitter Devices | AM_KSCATEGORY_SPLITTER | MERIT_DO_NOT_USE |
| WDM Streaming TV Audio Devices | AM_KSCATEGORY_TVAUDIO | MERIT_DO_NOT_USE |
| WDM Streaming TV Tuner Devices | AM_KSCATEGORY_TVTUNER | MERIT_DO_NOT_USE |
| WDM Streaming VBI Codecs | AM_KSCATEGORY_VBICODEC | MERIT_DO_NOT_USE |
Die folgenden Kategorien sind in der Header-Datei Ks.h deklariert.
| Anzeigename | CLSID | Verdienst |
|---|---|---|
| WDM Streaming Communication Transforms | KSCATEGORY_COMMUNICATIONSTRANSFORM | MERIT_DO_NOT_USE |
| WDM Streaming Data Transforms | KSCATEGORY_DATATRANSFORM | MERIT_DO_NOT_USE |
| WDM Streaming Interface Transforms | KSCATEGORY_INTERFACETRANSFORM | MERIT_DO_NOT_USE |
| WDM Streaming Mixer Devices | KSCATEGORY_MIXER | MERIT_DO_NOT_USE |
Die folgenden Kategorien werden in der Header-Datei Bdamedia.h deklariert. Binden Sie die folgenden Header-Dateien ein: ks.h, ksmedia.h, und bdamedia.h.
| Anzeigename | CLSID | Verdienst |
|---|---|---|
| BDA Network Providers | KSCATEGORY_BDA_NETWORK_PROVIDER | MERIT_NORMAL |
| BDA Receiver Components | KSCATEGORY_BDA_RECEIVER_COMPONENT | MERIT_DO_NOT_USE |
| BDA Rendering Filters | KSCATEGORY_IP_SINK | MERIT_DO_NOT_USE |
| BDA Source Filters | KSCATEGORY_BDA_NETWORK_TUNER | MERIT_DO_NOT_USE |
| BDA Transport Information Renderers | KSCATEGORY_BDA_TRANSPORT_INFORMATION | MERIT_NORMAL |
Hinweis
Decoder werden unter der Kategorie „DirectShow Filters“ registriert (CLSID_LegacyAmFilterCategory).
Andere Filterkategorien
Die hier aufgeführten Kategorien können mit dem System Device Enumerator aufgelistet werden, sind aber für den Filter Mapper nicht sichtbar und werden von Intelligent Connect nicht verwendet.
Die folgenden Kategorien werden in der Header-Datei Qedit.h deklariert.
| Anzeigename | CLID | Verdienst |
|---|---|---|
| Video Effects (1 Input) | CLSID_VideoEffects1Category | MERIT_DO_NOT_USE |
| Video Effects (2 Inputs) | CLSID_VideoEffects2Category | MERIT_DO_NOT_USE |
Diese Kategorien enthalten Videoeffekte und Übergänge für DirectShow Editing Services:
- Video Effects (1 input) enthält Videoeffekte.
- Video Effects (2 input) enthält Videoübergänge.
Weitere Informationen finden Sie unter Auflisten von Effekten und Übergängen.
Die folgenden Kategorien werden in der Header-Datei Uuids.h deklariert. Binden Sie die Header-Datei Dshow.h ein.
| Anzeigename | CLID | Verdienst |
|---|---|---|
| EncAPI Encoders | CLSID_MediaEncoderCategory | MERIT_DO_NOT_USE |
| EncAPI Multiplexers | CLSID_MediaMultiplexerCategory | MERIT_DO_NOT_USE |
DirectShow-Filter Meta-Kategorie
| Anzeigename | CLSID | Verdienst |
|---|---|---|
| ActiveMovie Filter-Kategorien | CLSID_ActiveMovieCategories | Nicht zutreffend |
Diese Metakategorie enthält eine Liste von Filterkategorien. Wenn eine Filterkategorie nicht in dieser Liste erscheint, ignoriert der Filter Mapper die Kategorie, was bedeutet, dass der Filter für Intelligent Connect nicht verfügbar ist.
Um die Liste der Filterkategorien aufzulisten, rufen Sie ICreateDevEnum::CreateClassEnumerator mit dem Wert CLSID_ActiveMovieCategories auf. Die von dieser Methode zurückgegebenen Moniker unterstützen die folgenden Eigenschaften.
| Eigenschaftenname | Beschreibung |
|---|---|
| „FriendlyName“ | Name der Kategorie (VT_BSTR). |
| „Merit“ | Merkmal der Kategorie (VT_I4). Wenn diese Eigenschaft nicht vorhanden ist, behandeln Sie sie als MERIT_DO_NOT_USE. |
| „CLSID“ | Kategorie CLSID (VT_BSTR). |
Um eine neue Filterkategorie zu dieser Liste hinzuzufügen, rufen Sie IFilterMapper2::CreateCategory auf.
DMO-Kategorien
DirectX Media Objects (DMOs) verwenden einen anderen Auflistungsmechanismus als DirectShow-Filter. Weitere Informationen finden Sie unter Registrieren eines DMO. Sie können jedoch den System Device Enumerator verwenden, um DMO-Kategorien aufzulisten. Die Moniker binden sich an den DMO Wrapper Filter und initialisieren den Filter automatisch mit dem DMO.
Darüber hinaus werden einige der DMO-Kategorien den DirectShow-Filterkategorien zugeordnet, um eine intelligente Verbindung herzustellen:
| DMO-Kategorie | DirectShow-Äquivalent |
|---|---|
| DMOCATEGORY_AUDIO_ENCODER | CLSID_AudioCompressorCategory |
| DMOCATEGORY_AUDIO_DECODER | CLSID_LegacyAmFilterCategory |
| DMOCATEGORY_VIDEO_ENCODER | CLSID_VideoCompressorCategory |
| DMOCATEGORY_VIDEO_DECODER | CLSID_LegacyAmFilterCategory |
Beachten Sie, dass die Kategorien Videoeffekt und Audioeffekt keinen DirectShow-Kategorien zugeordnet sind.