Méthode IFilterMapper2 ::CreateCategory (strmif.h)

  • Article

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La CreateCategory méthode ajoute une nouvelle catégorie de filtre au Registre.

Syntaxe

HRESULT CreateCategory(
  [in] REFCLSID clsidCategory,
  [in] DWORD    dwCategoryMerit,
  [in] LPCWSTR  Description
);

Paramètres

[in] clsidCategory

Identificateur de classe (CLSID) de la nouvelle catégorie de filtre.

[in] dwCategoryMerit

Mérite de la catégorie. Les catégories présentant un mérite plus élevé sont énumérées en premier.

[in] Description

Nom descriptif de la catégorie.

Valeur retournée

Retourne S_OK en cas de réussite ou une valeur HRESULT indiquant la cause de l’erreur.

Remarques

Le gestionnaire de graphe de filtre ignore initialement toutes les catégories dont la valeur de mérite est inférieure ou égale à MERIT_DO_NOT_USE, afin d’accélérer le processus de création de graphiques. Les catégories de filtres qui ne doivent pas être prises en compte pour la lecture doivent avoir un mérite de MERIT_DO_NOT_USE ou moins.

Un filtre peut apparaître dans une ou plusieurs catégories (par exemple, Compresseurs vidéo) pour restreindre l’espace de recherche.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête strmif.h (include Dshow.h)
Bibliothèque Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IFilterMapper2, interface