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

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.

Konstanten und GUIDs

Auflisten von Geräten und Filtern

Intelligentes Verbinden

Layout der Registrierungsschlüssel

Verwendung des Filter Mappers

Verwendung des System Device Enumerators