Interfaccia IPin (strmif.h)
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Questa interfaccia viene esposta da tutti i pin di input e output.
Gestione grafo filtri usa questa interfaccia per connettere i pin ed eseguire operazioni di scaricamento. Le applicazioni possono usare questa interfaccia per eseguire query sul pin per ottenere informazioni. Le applicazioni non devono mai chiamare IPin metodi che modificano lo stato di un pin, ad esempio Connect, Disconnect, BeginFlush o EndFlush. Per connettere i pin, un'applicazione deve usare i metodi in IGraphBuilder.
Filtrare gli sviluppatori: Le classi CBasePin, CBaseInputPin e CBaseOutputPin implementano questa interfaccia. Altre classi di base derivano da queste tre classi.
Ereditarietà
L'interfaccia IPin eredita dall'interfaccia IUnknown . IPin include anche questi tipi di membri:
Metodi
L'interfaccia IPin include questi metodi.
| IPin::BeginFlush Il metodo BeginFlush avvia un'operazione di scaricamento. (IPin.BeginFlush) |
| IPin::Connect Il metodo Connect connette il pin a un altro pin. |
| IPin::ConnectedTo Il metodo ConnectedTo recupera un puntatore al pin connesso, se presente. |
| IPin::ConnectionMediaType Il metodo ConnectionMediaType recupera il tipo di supporto per la connessione pin corrente, se presente. |
| IPin::D isconnect Il metodo Disconnect interrompe la connessione del pin corrente. |
| IPin::EndFlush Il metodo EndFlush termina un'operazione di scaricamento. (IPin.EndFlush) |
| IPin::EndOfStream Il metodo EndOfStream notifica al pin che non è previsto alcun dato aggiuntivo, fino a quando non viene eseguito un nuovo comando di esecuzione al filtro. |
| IPin::EnumMediaTypes Il metodo EnumMediaTypes enumera i tipi di supporti preferiti del pin. |
| IPin::NewSegment Il metodo NewSegment notifica al pin che i campioni multimediali ricevuti dopo questa chiamata vengono raggruppati come segmento, con un'ora di inizio comune, l'ora di arresto e la frequenza. |
| IPin::QueryAccept Il metodo QueryAccept determina se il pin accetta un tipo di supporto specificato. |
| IPin::QueryDirection Il metodo QueryDirection ottiene la direzione del pin (input o output). |
| IPin::QueryId Il metodo QueryId recupera un identificatore per il pin. |
| IPin::QueryInternalConnections Il metodo QueryInternalConnections recupera i pin connessi internamente a questo pin (all'interno del filtro). |
| IPin::QueryPinInfo Il metodo QueryPinInfo recupera informazioni sul pin. |
| IPin::ReceiveConnection Il metodo ReceiveConnection accetta una connessione da un altro pin. |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | strmif.h (include Dshow.h) |