Método IFilterMapper2::CreateCategory (strmif.h)
[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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de