Interfaccia IPortEvents (portcls.h)
L'interfaccia IPortEvents
viene usata dai driver miniport per notificare ai client eventi hardware. In Windows 98/Me e in Windows 2000 e versioni successive, tutti i driver di porta in portcls.sys implementare questa interfaccia ed esporlo ai driver miniport. Per determinare se un driver di porta supporta l'interfacciaIPortEvents
, il driver miniport chiama il metodo QueryInterface dell'oggetto IPortXxx con REFIID IID_IPortEvents. IPortEvents
eredita dall'interfaccia IUnknown .
I driver usano in genere l'interfaccia IPortEvents
per notificare al sistema le modifiche al volume generato dall'hardware o disattivarlo, anche se IPortEvents
può essere usato per qualsiasi tipo di notifica degli eventi. IPortEvents
interface è un'interfaccia facoltativa del driver di porta inferiore. Può essere utilizzato, ad esempio, per notificare le applicazioni mixer di modifiche di controllo o linea mixer . Per informazioni sull'API mixer, vedere la documentazione di Microsoft Windows SDK.
Un driver miniport espone un evento nello stesso modo in cui espone le proprietà: tramite una tabella di automazione (vedere PCAUTOMATION_TABLE). Gli oggetti seguenti, tutti esposti dal driver miniport, possono specificare una tabella di automazione che contiene proprietà ed eventi:
- Filtro implementato dal driver miniport
- Ogni pin esposto dal filtro
- Ogni nodo esposto dal filtro
- Set di eventi
- Evento all'interno del set
- Flag che indicano le opzioni di supporto
- Puntatore di funzione al gestore per l'evento
Oltre a esporre l'evento nella tabella di automazione, un driver miniport che deve esporre gli eventi deve eseguire una query sul driver di porta per l'interfaccia IPortEvents
.
Questa sezione descrive anche la routine seguente per la gestione delle richieste di eventi:
Ereditarietà
L'interfaccia IPortEvents eredita dall'interfaccia IUnknown.
Metodi
L'interfaccia IPortEvents include questi metodi.
IPortEvents::AddEventToEventList Il metodo AddEventToEventList aggiunge un evento all'elenco eventi del driver di porta. |
IPortEvents::GenerateEventList Il metodo GenerateEventList invia una notifica ai client tramite l'elenco di voci di evento del driver di porta che si è verificato un determinato evento. |
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Windows |
Intestazione | portcls.h |