PI8042_KEYBOARD_ISR função de retorno de chamada (ntdd8042.h)

Artigo
02/26/2024

Uma rotina de retorno de chamada do tipo PI8042_KEYBOARD_ISR personaliza a operação do ISR do teclado I8042prt.

Sintaxe

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

Ponteiro para o objeto de dispositivo de filtro do driver que fornece um retorno de chamada.

[in] CurrentInput

Ponteiro para a estrutura de KEYBOARD_INPUT_DATA de entrada que está sendo construída pelo ISR.

[in] CurrentOutput

Ponteiro para uma estrutura OUTPUT_PACKET , que especifica uma matriz de bytes que está sendo gravada no dispositivo de hardware.

[in] StatusByte

Especifica o status byte lido da porta de E/S 60 quando ocorre uma interrupção.

[in] Byte

Especifica o byte de dados lido da porta de E/S 64 quando ocorre uma interrupção.

[out] ContinueProcessing

Especifica, se TRUE, que o processamento no ISR do teclado I8042prt continuará após a conclusão desse retorno de chamada. Caso contrário, o processamento não continuará.

[in] ScanState

Ponteiro para um valor de enumeração KEYBOARD_SCAN_STATE, que identifica o estado de verificação do teclado.

Retornar valor

Um retorno de chamada PI8042_KEYBOARD_ISR retornará TRUE se o ISR do teclado I8042prt continuar; caso contrário, retornará FALSE.

Comentários

Um PI8042_KEYBOARD_ISR retorno de chamada não será necessário se a operação padrão do ISR do teclado I8042prt for suficiente.

Um driver de filtro de teclado opcional, fornecido pelo fornecedor e de nível superior, pode fornecer um retorno de chamada PI8042_KEYBOARD_ISR. O ISR I8042prt chama o retorno de chamada depois de validar a interrupção e ler o código de verificação.

O retorno de chamada PI8042_KEYBOARD_ISR é executado no modo kernel no IRQL do ISR do teclado I8042prt.