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

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O UnregisterFilter método remove informações de filtro do registro.

Sintaxe

HRESULT UnregisterFilter(
  [in] const CLSID *pclsidCategory,
  [in] LPCOLESTR   szInstance,
  [in] REFCLSID    Filter
);

Parâmetros

[in] pclsidCategory

Endereço de um GUID que especifica a categoria de filtro da qual remover o filtro. Para obter uma lista de categorias, consulte Categorias de filtro.

[in] szInstance

Dados de instância usados para construir o nome de exibição do moniker do dispositivo. Use o valor que foi originalmente passado para o método RegisterFilter .

[in] Filter

CLSID (identificador de classe) do filtro.

Retornar valor

Retorna S_OK se tiver êxito ou um valor HRESULT que indica a causa do erro.

Comentários

Se o filtro não tiver sido registrado, o método poderá retornar um erro.

Requisitos

Confira também

Códigos de erro e êxito

IFilterMapper2 Interface