Método CTransformFilter.GetPin

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El GetPin método recupera un pin.

Sintaxis

virtual CBasePin* GetPin(
   int n
);

Parámetros

n

Número del pin especificado, indizado desde cero. En este filtro, el pin 0 es el pin de entrada y el pin 1 es el pin de salida.

Valor devuelto

Devuelve un puntero al objeto CBasePin que implementa el pin o NULL si se produce un error en el método.

Observaciones

Este método implementa el método CBaseFilter::GetPin virtual puro. La primera vez que se llama al método , crea ambos pines.

Este método no incrementa el recuento de referencias en el pin devuelto, por lo que el pin devuelto no tiene un recuento de referencias pendiente. Si el autor de la llamada necesita mantener una referencia en el pin, debe llamar al método IUnknown::AddRef en el pin.

Si el filtro usa los pins CTransformInputPin y CTransformOutputPin predeterminados, probablemente no necesite invalidar este método. Sin embargo, si el filtro usa patillas que extienden esas clases, debe invalidar este método para crear patillas de ese tipo.

Requisitos

Consulte también

CTransformFilter (clase)