PI8042_MOUSE_ISR fonction de rappel (ntdd8042.h)

Article
02/07/2025

Une routine de rappel typée PI8042_MOUSE_ISR personnalise l’opération de l’ISR de la souris I8042prt.

Syntaxe

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

Paramètres

[in] IsrContext

Pointeur vers l’objet de périphérique de filtre du pilote qui fournit ce rappel.

[in] CurrentInput

Pointeur vers la structure d’entrée MOUSE_INPUT_DATA construite par l’ISR.

[in] CurrentOutput

Pointeur vers une structure OUTPUT_PACKET, qui spécifie un tableau d’octets en cours d’écriture sur l’appareil matériel.

[in] StatusByte

Spécifie un octet d’état lu à partir du port d’E/S 60 lorsque l’interruption se produit.

[in] Byte

Spécifie un octet de données lu à partir du port d’E/S 64 lorsque l’interruption se produit.

[in, out] ContinueProcessing

Spécifie, si TRUE, ce traitement dans l’ISR de la souris I8042prt se poursuit une fois ce rappel terminé. Sinon, le traitement ne se poursuit pas.

[in] MouseState

Pointeur vers une valeur d’énumération MOUSE_STATE, qui identifie l’état de l’entrée de la souris.

[in] ResetSubState

Pointeur vers MOUSE_RESET_SUBSTATE valeur d’énumération, qui identifie le sous-état de réinitialisation de la souris. Consultez la section Remarques.

Valeur de retour

Un rappel PI8042_MOUSE_ISR retourne TRUE si l’ISR de la souris I8042prt doit continuer ; sinon, elle retourne FALSE.

Remarques

Un rappel PI8042_MOUSE_ISR n’est pas nécessaire si l’opération par défaut de l’ISR de la souris I8042prt est suffisante.

Un pilote de filtre de clavier de niveau supérieur peut fournir un rappel ISR de souris. Une fois que l’ISR de la souris I8042prt valide l’interruption, elle appelle le rappel ISR de la souris.

Pour réinitialiser une souris, I8042prt passe par une séquence de sous-états opérationnels, chacun d’eux étant identifié par une valeur d’énumération MOUSE_RESET_SUBSTATE. Pour plus d’informations sur la façon dont I8042prt réinitialise une souris et les sous-états de réinitialisation de la souris correspondants, consultez la documentation de MOUSE_RESET_SUBSTATE dans ntdd8042.h.

Un rappel PI8042_MOUSE_ISR s’exécute en mode noyau à l’IRQL de l’ISR de la souris I8042prt.