Método CBaseFilter.FindPin

  • Artículo

[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 FindPin método recupera el pin con el identificador especificado. Este método implementa el método IBaseFilter::FindPin .

Sintaxis

HRESULT FindPin(
   LPCWSTR Id,
   IPin    **ppPin
);

Parámetros

Id

Puntero a una cadena Unicode terminada en null constante que identifica la patilla.

ppPin

Dirección de una variable que recibe un puntero a la interfaz IPin del pin.

Valor devuelto

Devuelve uno de los siguientes valores HRESULT .

Código devuelto Descripción
S_OK
 Correcto.
E_POINTER
 Argumento de puntero NULL.
VFW_E_NOT_FOUND
 No se pudo encontrar un pin coincidente.

Observaciones

Este método llama al método CBasePin::Name para comparar el nombre de cada patilla con la cadena especificada por el parámetro Id .

Si el método se realiza correctamente, la interfaz IPin tiene un recuento de referencias pendiente. Asegúrese de liberarlo cuando haya terminado.

Requisitos

Requisito Value
Encabezado
Amfilter.h (include Streams.h)
Biblioteca
Strmbase.lib (compilaciones comerciales);
Strmbasd.lib (compilaciones de depuración)

Consulte también

CBaseFilter (clase)