Método CTransformFilter.GetPin
[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 GetPin
método recupera um pino.
Sintaxe
virtual CBasePin* GetPin(
int n
);
Parâmetros
-
n
-
Número do pino especificado, indexado a partir de zero. Nesse filtro, o pino 0 é o pino de entrada e o pino 1 é o pino de saída.
Retornar valor
Retorna um ponteiro para o objeto CBasePin que implementa o pino ou NULL se o método falhar.
Comentários
Esse método implementa o método CBaseFilter::GetPin virtual puro. Na primeira vez que o método é chamado, ele cria ambos os pinos.
Esse método não incrementa a contagem de referência no pino retornado, portanto, o pino retornado não tem uma contagem de referência pendente. Se o chamador precisar manter uma referência no pino, ele deverá chamar o método IUnknown::AddRef no pino.
Se o filtro usar os pinos CTransformInputPin e CTransformOutputPin padrão, você provavelmente não precisará substituir esse método. No entanto, se o filtro usar pinos que estendem essas classes, você deverá substituir esse método para criar pinos desse tipo.
Requisitos
Requisito | Valor |
---|---|
parâmetro |
|
Biblioteca |
|