Compartir a través de


Interfaz IPin (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.

Esta interfaz se expone mediante todas las patillas de entrada y salida.

El administrador de gráficos de filtros usa esta interfaz para conectar patillas y realizar operaciones de vaciado. Las aplicaciones pueden usar esta interfaz para consultar el pin para obtener información. Las aplicaciones nunca deben llamar a IPin métodos que cambien el estado de un pin, como Connect, Disconnect, BeginFlush o EndFlush. Para conectar patillas, una aplicación debe usar los métodos de IGraphBuilder.

Filtrar desarrolladores: Las clases CBasePin, CBaseInputPin y CBaseOutputPin implementan esta interfaz. Otras clases base derivan de estas tres clases.

Herencia

La interfaz IPin hereda de la interfaz IUnknown . IPin también tiene estos tipos de miembros:

Métodos

La interfaz IPin tiene estos métodos.

 
IPin::BeginFlush

El método BeginFlush inicia una operación de vaciado. (IPin.BeginFlush)
IPin::Connect

El método Connect conecta el pin a otro pin.
IPin::ConnectedTo

El método ConnectedTo recupera un puntero al pin conectado, si existe.
IPin::ConnectionMediaType

El método ConnectionMediaType recupera el tipo de medio para la conexión de patillas actual, si existe.
IPin::D isconnect

El método Disconnect interrumpe la conexión de patillas actual.
IPin::EndFlush

El método EndFlush finaliza una operación de vaciado. (IPin.EndFlush)
IPin::EndOfStream

El método EndOfStream notifica al pin que no se espera ningún dato adicional, hasta que se emite un nuevo comando de ejecución al filtro.
IPin::EnumMediaTypes

El método EnumMediaTypes enumera los tipos de medios preferidos del pin.
IPin::NewSegment

El método NewSegment notifica al pin que los ejemplos multimedia recibidos después de esta llamada se agrupan como un segmento, con una hora de inicio común, una hora de detención y una velocidad.
IPin::QueryAccept

El método QueryAccept determina si el pin acepta un tipo de medio especificado.
IPin::QueryDirection

El método QueryDirection obtiene la dirección del pin (entrada o salida).
IPin::QueryId

El método QueryId recupera un identificador para el pin.
IPin::QueryInternalConnections

El método QueryInternalConnections recupera las patillas que están conectadas internamente a este pin (dentro del filtro).
IPin::QueryPinInfo

El método QueryPinInfo recupera información sobre el pin.
IPin::ReceiveConnection

El método ReceiveConnection acepta una conexión de otro pin.

Requisitos

Requisito Value
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)