Estrutura REGFILTERPINS (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.]

A REGFILTERPINS estrutura contém informações de fixação para registrar um filtro.

Sintaxe

typedef struct REGFILTERPINS {
  LPWSTR            strName;
  BOOL              bRendered;
  BOOL              bOutput;
  BOOL              bZero;
  BOOL              bMany;
  const CLSID       *clsConnectsToFilter;
  const WCHAR       *strConnectsToPin;
  UINT              nMediaTypes;
  const REGPINTYPES *lpMediaType;
} REGFILTERPINS;

Membros

strName

Nome do pino. (Obsoleto.)

bRendered

Se TRUE, o filtro renderizará a entrada desse pino. (Aplica-se somente a pinos de entrada. Para pinos de saída, o valor é sempre FALSE.)

bOutput

Se TRUE, esse pino será um pino de saída. Caso contrário, o pino será um pino de entrada.

bZero

Se TRUE, o filtro poderá ter zero instâncias desse pino.

bMany

Se TRUE, o filtro poderá criar mais de uma instância desse tipo de pin.

clsConnectsToFilter

CLSID (identificador de classe) do filtro ao qual esse pino se conecta. (Obsoleto.)

strConnectsToPin

Nome do pino ao qual esse pino se conecta. (Obsoleto.)

nMediaTypes

Número de tipos de mídia compatíveis com esse pin.

lpMediaType

Ponteiro para uma matriz de estruturas REGPINTYPES , de tamanho nMediaTypes.

Comentários

Essa estrutura é usada na interface IFilterMapper2 para registro de filtro. Se você usar essa estrutura, defina o membro dwVersion da estrutura REGFILTER2 como 1. Se você precisar registrar uma categoria média ou fixada para o pino, use a estrutura REGFILTERPINS2 . Nesse caso, defina o membro dwVersion da estrutura REGFILTER2 como 2.

O tipo de AMOVIESETUP_PIN equivalente é usado em modelos de fábrica de classes (CFactoryTemplate).

Os membros strName, clsConnectsToFilter e strConnectsToPin estão obsoletos. Seus valores não são adicionados ao registro.

Para obter mais informações, consulte Como registrar filtros do DirectShow.

Requisitos

Requisito	Valor
Cabeçalho	strmif.h (inclua Dshow.h)

Confira também

Estruturas do DirectShow