Método IFilterMapper::RegisterPin (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na 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 Captura de Áudio/Vídeo no 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.]

Nota A interface IFilterMapper foi preterida. Em vez disso , use IFilterMapper2 .

 

Registra os detalhes do pino no registro.

Sintaxe

HRESULT RegisterPin(
  [in] CLSID   Filter,
  [in] LPCWSTR Name,
  [in] BOOL    bRendered,
  [in] BOOL    bOutput,
  [in] BOOL    bZero,
  [in] BOOL    bMany,
  [in] CLSID   ConnectsToFilter,
  [in] LPCWSTR ConnectsToPin
);

Parâmetros

[in] Filter

GUID do filtro.

[in] Name

Nome do pino. Isso deve ser exclusivo dentro do filtro. Ele não tem nenhum significado além de indicar informações de tipo. Você não deve usar nomes de pin com mais de 99 caracteres, pois isso causa problemas de enumeração de filtro.

[in] bRendered

Valor que especifica se o filtro renderiza essa entrada. Defina como TRUE se isso acontecer; caso contrário, defina como FALSE.

[in] bOutput

Valor que especifica se esse é um pino de saída. Defina como TRUE se for; caso contrário, defina como FALSE.

[in] bZero

Valor que especifica se o filtro pode ter zero instâncias desse pino. Se puder, defina como TRUE; caso contrário, defina como FALSE. Por exemplo, um filtro de descompactação não precisa criar um pino de saída de som para um filme sem uma faixa de som.

[in] bMany

Valor que especifica se o filtro pode ter muitas instâncias desse pino. Se puder, defina como TRUE; caso contrário, defina como FALSE. Por exemplo, um mixer pode ter várias instâncias de seu pino de entrada.

[in] ConnectsToFilter

Reservado. Deve ser NULL. (Isso se destina a filtros como misturadores de todo o sistema que têm conexões fora do grafo de filtro. Ele ainda não foi implementado.)

[in] ConnectsToPin

Reservado. Deve ser NULL.

Retornar valor

Retorna um valor HRESULT .

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	strmif.h (inclua Dshow.h)

Confira também

Códigos de erro e êxito

IFilterMapper Interface