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