Interfaz IInterruptSync (portcls.h)
La IInterruptSync
interfaz representa un objeto de sincronización de interrupciones que sincroniza la ejecución de una lista de rutinas de servicio de interrupción (ISR) con rutinas que no son ISR. El controlador del sistema PortCls implementa esta interfaz y la expone al controlador del adaptador. Un controlador de minipuerto obtiene una referencia a un IInterruptSync
objeto llamando a la función PortCls PcNewInterruptSync, que crea un nuevo IInterruptSync
objeto que se conecta a un recurso de interrupción. IInterruptSync
hereda de la interfaz IUnknown .
El método IInterruptSync::RegisterServiceRoutine asocia un ISR a un objeto de sincronización. Se puede asociar más de un ISR a un único objeto de sincronización. Cuando se produce la interrupción, el objeto de sincronización ejecuta los ISR en la lista en un orden especificado y de acuerdo con el parámetro Mode de la función PcNewInterruptSync.
Otra faceta de IInterruptSync
es su capacidad de sincronizar la ejecución de ISR con otras rutinas que no son ISR. Una vez que se pasa una rutina que no es ISR a IInterruptSync::CallSynchronizedRoutine y comienza a ejecutarse, se garantiza que la ejecución de cualquier ISR registrada con el objeto de sincronización se mantenga desactivada hasta que esa rutina haya terminado de ejecutarse.
Los métodos RegisterServiceRoutine y CallSynchronizedRoutine aceptan punteros de función de tipo PINTERRUPTSYNCROUTINE, que se define de la siguiente manera:
typedef NTSTATUS (*PINTERRUPTSYNCROUTINE)
(
IN struct IInterruptSync *InterruptSync,
IN PVOID DynamicContext
);
El miembro InterruptSync es un puntero al objeto de sincronización. El miembro DynamicContext contiene un valor de contexto que se pasa a la rutina cuando se llama a .
Para obtener más información, vea Interrumpir objetos de sincronización.
Herencia
La interfaz IInterruptSync hereda de la interfaz IUnknown.
Métodos
La interfaz IInterruptSync tiene estos métodos.
IInterruptSync::CallSynchronizedRoutine El método CallSynchronizedRoutine llama a una rutina que no es una rutina de servicio de interrupción (ISR), pero cuya ejecución debe sincronizarse con ISR. |
IInterruptSync::Connect El método Connect conecta el objeto de sincronización a la interrupción. |
IInterruptSync::D isconnect El método Disconnect desconecta el objeto de sincronización de la interrupción. |
IInterruptSync::GetKInterrupt El método GetKInterrupt obtiene un objeto de interrupción de WDM de un objeto de sincronización de clase de puerto. |
IInterruptSync::RegisterServiceRoutine El método RegisterServiceRoutine registra una rutina de servicio de interrupción (ISR) a la que se va a llamar cuando se produce una interrupción. |
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Windows |
Encabezado | portcls.h |