Compartir a través de


Método CTransformFilter.FindPin

[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 método FindPin obtiene 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

Cadena de caracteres anchos que contiene el identificador de patilla.

ppPin

Recibe un puntero a la interfaz IPin del pin. Si se produce un error en el método, *ppPin se establece en NULL.

Valor devuelto

Devuelve uno de los valores HRESULT que se muestran en la tabla siguiente.

Código devuelto Descripción
S_OK
Correcto.
E_OUTOFMEMORY
Memoria insuficiente.
E_POINTER
Argumento de puntero NULL.
VFW_E_NOT_FOUND
No se pudo encontrar un pin con este identificador.

Observaciones

Importante

La implementación de este método no llama a IPin::QueryId para que coincida con el identificador de patilla. En su lugar, el método supone que el pin de entrada se denomina "In" y el pin de salida se denomina "Out". Si usa un conjunto diferente de identificadores de patillas, invalide este método.

Requisitos

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

Consulte también

CTransformFilter (clase)