Método ICaptureGraphBuilder2::FindPin (strmif.h)

[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 un pin determinado en un filtro o determina si un pin determinado coincide con los criterios especificados.

Sintaxis

HRESULT FindPin(
  [in]  IUnknown      *pSource,
  [in]  PIN_DIRECTION pindir,
  [in]  const GUID    *pCategory,
  [in]  const GUID    *pType,
  [in]  BOOL          fUnconnected,
  [in]  int           num,
  [out] IPin          **ppPin
);

Parámetros

[in] pSource

Puntero a una interfaz en un filtro o a una interfaz en un pin.

[in] pindir

Miembro de la enumeración PIN_DIRECTION que especifica la dirección del pin (entrada o salida).

[in] pCategory

Puntero a un GUID que especifica una de las categorías de patillas enumeradas en Conjunto de propiedades de pin. Para que coincida con cualquier pin, independientemente de la categoría, establezca este parámetro en NULL.

[in] pType

Puntero a un GUID de tipo principal que especifica el tipo de medio. Use NULL para que coincida con cualquier tipo de medio.

[in] fUnconnected

Valor booleano que especifica si el pin debe estar desconectado. Si es TRUE, el pin debe estar desconectado. Si es FALSE, el pin se puede conectar o desconectar.

[in] num

Índice de base cero del pin que se va a recuperar, del conjunto de patillas coincidentes. Si pSource es un puntero a un filtro y más de un pin coincide con los criterios de búsqueda, este parámetro especifica qué patilla se va a recuperar. Si pSource es un puntero a un pin, este parámetro se omite.

[out] ppPin

Dirección de un puntero para recibir la interfaz IPin del pin coincidente.

Valor devuelto

Devuelve S_OK si se encuentra un pin coincidente o E_FAIL de lo contrario.

Observaciones

Si pSource es un puntero a un filtro, el método busca elésimo pin en ese filtro que coincida con los criterios de búsqueda, donde n recibe el parámetro num . Si el método encuentra un pin coincidente, devuelve un puntero al pin en el parámetro ppPin .

Si pSource es un puntero a un pin, el método prueba que se ancla con los criterios de búsqueda. Si el pin coincide con los criterios, el método devuelve S_OK y devuelve un puntero a la interfaz IPin del pin en el parámetro ppPin . De lo contrario, devuelve E_FAIL.

En cualquier caso, si el método se realiza correctamente, la interfaz IPin devuelta en el parámetro ppPin tiene un recuento de referencias pendiente. Asegúrese de liberar la interfaz cuando haya terminado de usarlo.

Normalmente, una aplicación no tendrá que usar este método. Se proporciona para tareas inusualmente complejas, cuando el método ICaptureGraphBuilder2::RenderStream no puede compilar el gráfico de filtros. Use este método para recuperar un pin deseado de un filtro de captura y, a continuación, compilar el resto del grafo manualmente.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	strmif.h (incluya Dshow.h)
Library	Strmiids.lib

Consulte también

Códigos de error y éxito

ICaptureGraphBuilder2 (Interfaz)