Kategorien filtern

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit 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 die Filterzuordnung jedoch Kategorien mit MERIT_DO_NOT_USE oder weniger. Weitere Informationen finden Sie unter IFilterMapper2::EnumMatchingFilters. Alle hier aufgeführten Kategorien können auch mit dem Systemgeräte-Enumerator aufgelistet werden.

Die folgenden Kategorien werden in Uuids.h deklariert. Schließen Sie die Headerdatei Dshow.h ein.

Anzeigename CLSID Verdienst
Audioaufnahmequellen CLSID_AudioInputDeviceCategory MERIT_DO_NOT_USE
Audiokompressoren CLSID_AudioCompressorCategory MERIT_DO_NOT_USE
Audiorenderer CLSID_AudioRendererCategory MERIT_NORMAL
Gerätesteuerungsfilter CLSID_DeviceControlCategory MERIT_DO_NOT_USE
DirectShow-Filter CLSID_LegacyAmFilterCategory MERIT_NORMAL
Externe Renderer CLSID_TransmitCategory MERIT_DO_NOT_USE
Midi-Renderer CLSID_MidiRendererCategory MERIT_NORMAL
Videoaufnahmequellen CLSID_VideoInputDeviceCategory MERIT_DO_NOT_USE
Videokompressoren CLSID_VideoCompressorCategory MERIT_DO_NOT_USE
WDM-Stream-Dekomprimierungsgeräte CLSID_DVDHWDecodersCategoryHinweis: Diese Kategorie enthält Hardware-DVD-Decoder.
MERIT_DO_NOT_USE
WDM-Streamingerfassungsgeräte AM_KSCATEGORY_CAPTURE MERIT_DO_NOT_USE
WDM Streaming Crossbar-Geräte AM_KSCATEGORY_CROSSBAR MERIT_DO_NOT_USE
WDM-Streamingrenderinggeräte AM_KSCATEGORY_RENDER MERIT_DO_NOT_USE
WDM-Streaming-Tee/Splittergeräte AM_KSCATEGORY_SPLITTER MERIT_DO_NOT_USE
WDM-Streaming-TV-Audiogeräte AM_KSCATEGORY_TVAUDIO MERIT_DO_NOT_USE
WDM-Streaming-TV-Tunergeräte AM_KSCATEGORY_TVTUNER MERIT_DO_NOT_USE
WDM Streaming-VBI-Codecs AM_KSCATEGORY_VBICODEC MERIT_DO_NOT_USE

Die folgenden Kategorien werden in der Headerdatei Ks.h deklariert.

Anzeigename CLSID Verdienst
WDM-Streamingkommunikationstransformationen KSCATEGORY_COMMUNICATIONSTRANSFORM MERIT_DO_NOT_USE
WDM-Streamingdatentransformationen KSCATEGORY_DATATRANSFORM MERIT_DO_NOT_USE
WDM-Streamingschnittstellentransformationen KSCATEGORY_INTERFACETRANSFORM MERIT_DO_NOT_USE
WDM-Streamingmixergeräte KSCATEGORY_MIXER MERIT_DO_NOT_USE

Die folgenden Kategorien werden in der Headerdatei Bdamedia.h deklariert. Fügen Sie die folgenden Headerdateien ein: ks.h, ksmedia.h und bdamedia.h.

Anzeigename CLSID Verdienst
BDA-Netzwerkanbieter KSCATEGORY_BDA_NETWORK_PROVIDER MERIT_NORMAL
BDA-Empfängerkomponenten KSCATEGORY_BDA_RECEIVER_COMPONENT MERIT_DO_NOT_USE
BDA-Renderingfilter KSCATEGORY_IP_SINK MERIT_DO_NOT_USE
BDA-Quellfilter KSCATEGORY_BDA_NETWORK_TUNER MERIT_DO_NOT_USE
BDA-Transportinformationsrenderer KSCATEGORY_BDA_TRANSPORT_INFORMATION MERIT_NORMAL

Hinweis

Decoder werden unter der Kategorie "DirectShow-Filter" (CLSID_LegacyAmFilterCategory) registriert.

Andere Filterkategorien

Die hier aufgeführten Kategorien können mit dem Systemgeräte-Enumerator aufgezählt werden, sind aber für die Filterzuordnung nicht sichtbar und werden von Intelligent Connect nicht verwendet.

Die folgenden Kategorien werden in der Headerdatei Qedit.h deklariert.

Anzeigename CLID Verdienst
Videoeffekte (1 Eingabe) CLSID_VideoEffects1Category MERIT_DO_NOT_USE
Videoeffekte (2 Eingaben) CLSID_VideoEffects2Category MERIT_DO_NOT_USE

Diese Kategorien enthalten Videoeffekte und Übergänge für DirectShow Editing Services:

  • "Videoeffekte (1 Eingabe)" enthält Videoeffekte.
  • "Videoeffekte (2 Eingabe)" enthält Videoübergänge.

Weitere Informationen finden Sie unter Aufzählung von Effekten und Übergängen.

Die folgenden Kategorien werden in der Headerdatei Uuids.h deklariert. Schließen Sie die Headerdatei Dshow.h ein.

Anzeigename CLID Verdienst
EncAPI-Encoder CLSID_MediaEncoderCategory MERIT_DO_NOT_USE
EncAPI-Multiplexer CLSID_MediaMultiplexerCategory MERIT_DO_NOT_USE

DirectShow-Filter Meta-Category

Anzeigename CLSID Verdienst
ActiveMovie-Filterkategorien CLSID_ActiveMovieCategories Nicht verfügbar

Diese Metakategorie enthält eine Liste von Filterkategorien. Wenn in dieser Liste keine Filterkategorie angezeigt wird, ignoriert der Filterzuordnungsgeber 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" Kategoriename (VT_BSTR).
"Verdienst" Kategorieverdienst (VT_I4). Wenn diese Eigenschaft nicht vorhanden ist, behandeln Sie als MERIT_DO_NOT_USE.
"CLSID" Kategorie CLSID (VT_BSTR).

Um dieser Liste eine neue Filterkategorie hinzuzufügen, rufen Sie IFilterMapper2::CreateCategory auf.

DMO-Kategorien

DirectX Media Objects (DMOs) verwenden einen anderen Enumerationsmechanismus als DirectShow-Filter. Weitere Informationen finden Sie unter Registrieren einer DMO. Sie können jedoch den Systemgeräte-Enumerator verwenden, um DMO-Kategorien aufzulisten. Die Moniker binden an den DMO-Wrapperfilter und initialisieren den Filter automatisch mit dem DMO.

Darüber hinaus werden einige der DMO-Kategorien directShow-Filterkategorien zugeordnet, um eine intelligente Verbindung herzustellen:

DMO-Kategorie DirectShow-Entsprechung
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 Für Videoeffekt und Audioeffekt keine DirectShow-Kategorien zugeordnet sind.

Konstanten und GUIDs

Auflisten von Geräten und Filtern

Intelligente Verbindung

Layout der Registrierungsschlüssel

Verwenden der Filterzuordnung

Verwenden des Systemgeräte-Enumerators