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

  • Artigo

[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 RegisterFilter método adiciona informações de filtro ao registro.

Sintaxe

HRESULT RegisterFilter(
  [in]      REFCLSID         clsidFilter,
  [in]      LPCWSTR          Name,
  [in, out] IMoniker         **ppMoniker,
  [in]      const CLSID      *pclsidCategory,
  [in]      LPCOLESTR        szInstance,
  [in]      const REGFILTER2 *prf2
);

Parâmetros

[in] clsidFilter

CLSID (identificador de classe) do filtro.

[in] Name

Nome descritivo para o filtro.

[in, out] ppMoniker

Endereço de um ponteiro para um moniker de dispositivo que determina onde os dados desse filtro serão gravados. Pode ser NULL.

[in] pclsidCategory

Ponteiro para a categoria de filtro do filtro. Se FOR NULL, a categoria padrão será CLSID_ActiveMovieFilters. (Consulte Categorias de filtro.)

[in] szInstance

Dados de instância para construir o nome de exibição do moniker do dispositivo. Pode ser o nome amigável ou a representação de cadeia de caracteres do filtro CLSID. Se FOR NULL, o padrão será o CLSID do filtro.

[in] prf2

Ponteiro para uma estrutura REGFILTER2 que contém informações de filtro.

Retornar valor

Retorna um valor HRESULT . Os valores possíveis incluem aqueles mostrados na tabela a seguir.

Código de retorno Descrição
S_OK
 Êxito.
VFW_E_BAD_KEY
 Não foi possível obter a chave do Registro.

Comentários

Esse método adiciona informações sobre o filtro ao registro, na entrada do Registro para a categoria de filtro especificada. Ele não registra o servidor em processo que cria o filtro (geralmente uma DLL). Para registrar o servidor, você pode chamar a função AMovieDllRegisterServer2 .

Para o parâmetro ppMoniker , use um dos seguintes:

  • O endereço de um ponteiro de interface IMoniker para um moniker de dispositivo existente
  • O endereço de um ponteiro de interface IMonikerNULL
  • NULL
Se você estiver registrando um filtro para um WDM (Modelo de Driver do Windows) ou Plug and Play dispositivo, passe o endereço do moniker de dispositivo existente. O filtro será registrado usando este moniker. Quando o método retorna, *ppMoniker é definido como NULL.

Caso contrário, o método criará um novo moniker. Se ppMoniker não for NULL, o método definirá *ppMoniker para apontar para o novo moniker. O aplicativo pode usar esse moniker para gravar valores privados adicionais no recipiente de propriedades. Certifique-se de liberar a interface .

Defina ppMoniker como NULL se você não quiser fornecer ou receber o moniker.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

Códigos de erro e êxito

IFilterMapper2 Interface