PI8042_MOUSE_ISR funzione di callback (ntdd8042.h)

Articolo
02/29/2024

Una routine di callback tipizzata PI8042_MOUSE_ISR consente di personalizzare l'operazione dell'ISR del mouse I8042prt.

Sintassi

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
)
{...}

Parametri

[in] IsrContext

Puntatore all'oggetto dispositivo di filtro del driver che fornisce questo callback.

[in] CurrentInput

Puntatore all'input MOUSE_INPUT_DATA struttura costruita dall'ISR.

[in] CurrentOutput

Puntatore a una struttura OUTPUT_PACKET , che specifica una matrice di byte scritti nel dispositivo hardware.

[in] StatusByte

Specifica un byte di stato letto dalla porta di I/O 60 quando si verifica l'interruzione.

[in] Byte

Specifica un byte di dati letto dalla porta di I/O 64 quando si verifica l'interruzione.

[in, out] ContinueProcessing

Specifica che, se TRUE, l'elaborazione nell'ISR del mouse I8042prt continuerà dopo il completamento di questo callback. In caso contrario, l'elaborazione non continua.

[in] MouseState

Puntatore a un valore di enumerazione MOUSE_STATE, che identifica lo stato dell'input del mouse.

[in] ResetSubState

Puntatore a MOUSE_RESET_SUBSTATE valore di enumerazione, che identifica lo stato secondario di reimpostazione del mouse. Vedere la sezione relativa alle osservazioni.

Valore restituito

Un callback PI8042_MOUSE_ISR restituisce TRUE se l'ISR del mouse I8042prt deve continuare; in caso contrario restituisce FALSE.

Commenti

Un callback PI8042_MOUSE_ISR non è necessario se l'operazione predefinita dell'ISR del mouse I8042prt è sufficiente.

Un driver di filtro da tastiera di livello superiore può fornire un callback ISR del mouse. Dopo che l'ISR del mouse I8042prt convalida l'interrupt, chiama il callback isr del mouse.

Per reimpostare un mouse, I8042prt passa attraverso una sequenza di sottostate operative, ognuna delle quali è identificata da un valore di enumerazione MOUSE_RESET_SUBSTATE. Per altre informazioni su come I8042prt reimposta un mouse e le sottostate di reimpostazione del mouse corrispondenti, vedere la documentazione di MOUSE_RESET_SUBSTATE in ntdd8042.h.

Un callback PI8042_MOUSE_ISR viene eseguito in modalità kernel in IRQL dell'ISR del mouse I8042prt.