PI8042_MOUSE_ISR fonction de rappel (ntdd8042.h)

Article
03/01/2024

Une routine de rappel de type PI8042_MOUSE_ISR personnalise le fonctionnement 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 l’entrée MOUSE_INPUT_DATA structure en cours de construction 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 status octet 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 la valeur est TRUE, que le traitement dans l’ISR de la souris I8042prt se poursuivra 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 Notes.

Valeur retournée

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 la souris I8042prt ISR est suffisante.

Un pilote de filtre clavier de niveau supérieur peut fournir un rappel ISR de souris. Une fois que l’ISR de la souris I8042prt a validé l’interruption, il 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 souris I8042prt.