Metodo IFilterMapper::RegisterFilter (strmif.h)

Articolo
07/28/2023

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine 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, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Nota L'interfaccia IFilterMapper è deprecata. Usare invece IFilterMapper2 .

Aggiunge un filtro al Registro di sistema; il filtro può quindi essere enumerato.

Sintassi

HRESULT RegisterFilter(
  [in] CLSID   clsid,
  [in] LPCWSTR Name,
  [in] DWORD   dwMerit
);

Parametri

[in] clsid

Identificatore univoco globale (GUID) del filtro.

[in] Name

Nome descrittivo per il filtro.

[in] dwMerit

Posizione nell'ordine di enumerazione. I filtri con meriti più elevati vengono enumerati per primi.

Valore restituito

Restituisce un valore HRESULT .

Commenti

Il merito (come definito dal parametro dwMerit ) controlla l'ordine in cui la gestione del grafo dei filtri tenta di filtrare quando si esegue un'operazione in seguito a una chiamata a IGraphBuilder::Connect, IGraphBuilder::Render o IGraphBuilder::RenderFile. Il gestore del grafo dei filtri trova tutti i filtri registrati con il tipo di supporto corretto e quindi prova quello con il massimo merito, usando altri criteri nella registrazione per scegliere tra i filtri con uguale merito.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)

Vedi anche

Codici di errore e di esito positivo

Interfaccia IFilterMapper

Condividi tramite