Metodo IFilterMapper2::CreateCategory (strmif.h)

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il CreateCategory metodo aggiunge una nuova categoria di filtro al Registro di sistema.

Sintassi

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

Parametri

[in] clsidCategory

Identificatore di classe (CLSID) della nuova categoria di filtro.

[in] dwCategoryMerit

Merito della categoria. Le categorie con meriti superiori vengono enumerate prima.

[in] Description

Nome descrittivo per la categoria.

Valore restituito

Restituisce S_OK se ha esito positivo o un valore HRESULT che indica la causa dell'errore.

Commenti

La gestione grafo filtro ignora inizialmente tutte le categorie con un valore di merito minore o uguale a MERIT_DO_NOT_USE, per velocizzare il processo di compilazione del grafico. Le categorie di filtro che non devono essere considerate per la riproduzione devono avere un merito di MERIT_DO_NOT_USE o meno.

Un filtro può essere visualizzato in una o più categorie (ad esempio, Compressori video) per limitare lo spazio di ricerca.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione strmif.h (include Dshow.h)
Libreria Strmiids.lib

Vedi anche

Codici errore e esito positivo

Interfaccia IFilterMapper2