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

  • Artículo

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El CreateCategory método agrega una nueva categoría de filtro al Registro.

Sintaxis

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

Parámetros

[in] clsidCategory

Identificador de clase (CLSID) de la nueva categoría de filtro.

[in] dwCategoryMerit

Mérito de la categoría. Las categorías con mérito superior se enumeran primero.

[in] Description

Nombre descriptivo de la categoría.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente o un valor HRESULT que indica la causa del error.

Comentarios

El administrador de gráficos de filtros omite inicialmente todas las categorías con un valor de mérito menor o igual que MERIT_DO_NOT_USE, para acelerar el proceso de creación de gráficos. Las categorías de filtro que no se deben tener en cuenta para la reproducción deben tener un mérito de MERIT_DO_NOT_USE o menos.

Un filtro puede aparecer en una o varias categorías (por ejemplo, Compresores de vídeo) para restringir el espacio de búsqueda.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado strmif.h (incluye Dshow.h)
Library Strmiids.lib

Consulte también

Códigos de error y éxito

IFilterMapper2 (Interfaz)