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

Artículo
02/29/2024

Una rutina de devolución de llamada con tipo PI8042_KEYBOARD_ISR personaliza la operación del ISR de teclado I8042prt.

Sintaxis

PI8042_KEYBOARD_ISR Pi8042KeyboardIsr;

BOOLEAN Pi8042KeyboardIsr(
  [in]  PVOID IsrContext,
  [in]  PKEYBOARD_INPUT_DATA CurrentInput,
  [in]  POUTPUT_PACKET CurrentOutput,
  [in]  UCHAR StatusByte,
  [in]  PUCHAR Byte,
  [out] PBOOLEAN ContinueProcessing,
  [in]  PKEYBOARD_SCAN_STATE ScanState
)
{...}

Parámetros

[in] IsrContext

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

[in] CurrentInput

Puntero a la estructura de KEYBOARD_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 el byte de estado que se lee del puerto de E/S 60 cuando se produce una interrupción.

[in] Byte

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

[out] ContinueProcessing

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

[in] ScanState

Puntero a un valor de enumeración KEYBOARD_SCAN_STATE , que identifica el estado del examen del teclado.

Valor devuelto

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

Comentarios

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

Un controlador opcional de filtro de teclado de nivel superior proporcionado por el proveedor puede proporcionar una devolución de llamada PI8042_KEYBOARD_ISR. El ISR I8042prt llama a la devolución de llamada después de validar la interrupción y lee el código de examen.

La devolución de llamada PI8042_KEYBOARD_ISR se ejecuta en modo kernel en el IRQL del ISR de teclado I8042prt.