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

Artigo
02/26/2024

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

Sintaxe

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

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

[in] CurrentInput

Ponteiro para a estrutura de MOUSE_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 sendo gravados no dispositivo de hardware.

[in] StatusByte

Especifica um byte status que é lido da porta de E/S 60 quando ocorre a interrupção.

[in] Byte

Especifica um byte de dados que é lido da porta de E/S 64 quando a interrupção ocorre.

[in, out] ContinueProcessing

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

[in] MouseState

Ponteiro para um valor de enumeração MOUSE_STATE , que identifica o estado da entrada do mouse.

[in] ResetSubState

Ponteiro para MOUSE_RESET_SUBSTATE valor de enumeração, que identifica o subestado de redefinição do mouse. Consulte a seção Comentários.

Retornar valor

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

Comentários

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

Um driver de filtro de teclado de nível superior pode fornecer um retorno de chamada ISR do mouse. Depois que o ISR do mouse I8042prt validar a interrupção, ele chama o retorno de chamada ISR do mouse.

Para redefinir um mouse, i8042prt passa por uma sequência de subestados operacionais, cada um dos quais é identificado por um valor de enumeração MOUSE_RESET_SUBSTATE. Para obter mais informações sobre como o I8042prt redefine um mouse e os subestados de redefinição de mouse correspondentes, consulte a documentação de MOUSE_RESET_SUBSTATE em ntdd8042.h.

Um retorno de chamada PI8042_MOUSE_ISR é executado no modo kernel no IRQL do ISR do mouse I8042prt.