PI8042_MOUSE_ISR función de devolución de llamada (ntdd8042.h)

Artículo
02/07/2025

Una rutina de devolución de llamada con tipo PI8042_MOUSE_ISR personaliza el funcionamiento del ISR del mouse I8042prt.

Sintaxis

PI8042_MOUSE_ISR Pi8042MouseIsr;

BOOLEAN Pi8042MouseIsr(
  [in]      PVOID IsrContext,
  [in]      PMOUSE_INPUT_DATA CurrentInput,
  [in]      POUTPUT_PACKET CurrentOutput,
  [in]      UCHAR StatusByte,
  [in]      PUCHAR Byte,
  [in, out] PBOOLEAN ContinueProcessing,
  [in]      PMOUSE_STATE MouseState,
  [in]      PMOUSE_RESET_SUBSTATE ResetSubState
)
{...}

Parámetros

[in] IsrContext

Puntero al objeto de dispositivo de filtro del controlador que proporciona esta devolución de llamada.

[in] CurrentInput

Puntero a la estructura MOUSE_INPUT_DATA de entrada que está construyendo el ISR.

[in] CurrentOutput

Puntero a una estructura de OUTPUT_PACKET, que especifica una matriz de bytes que se escribe en el dispositivo de hardware.

[in] StatusByte

Especifica un byte de estado que se lee desde el puerto de E/S 60 cuando se produce la interrupción.

[in] Byte

Especifica un byte de datos que se lee desde el puerto de E/S 64 cuando se produce la interrupción.

[in, out] ContinueProcessing

Especifica, si TRUE, ese procesamiento en el ISR del mouse I8042prt continuará una vez completada esta devolución de llamada. De lo contrario, el procesamiento no continúa.

[in] MouseState

Puntero a un valor de enumeración MOUSE_STATE, que identifica el estado de la entrada del mouse.

[in] ResetSubState

Puntero a MOUSE_RESET_SUBSTATE valor de enumeración, que identifica el subestado de restablecimiento del mouse. Consulte la sección Comentarios.

Valor devuelto

Una devolución de llamada PI8042_MOUSE_ISR devuelve TRUE si el ISR del mouse I8042prt debe continuar; de lo contrario, devuelve FALSE.

Observaciones

No se necesita una devolución de llamada PI8042_MOUSE_ISR si la operación predeterminada del ISR del mouse I8042prt es suficiente.

Un controlador de filtro de teclado de nivel superior puede proporcionar una devolución de llamada ISR del mouse. Una vez que el ISR del mouse I8042prt valida la interrupción, llama a la devolución de llamada isr del mouse.

Para restablecer un mouse, I8042prt pasa por una secuencia de subestados operativos, cada uno de los cuales se identifica mediante un valor de enumeración MOUSE_RESET_SUBSTATE. Para obtener más información sobre cómo I8042prt restablece un mouse y los subestados de restablecimiento del mouse correspondientes, consulte la documentación de MOUSE_RESET_SUBSTATE en ntdd8042.h.

Una devolución de llamada PI8042_MOUSE_ISR se ejecuta en modo kernel en irQL del ISR del mouse I8042prt.