PI8042_KEYBOARD_ISR funzione di callback (ntdd8042.h)

Articolo
02/07/2025

Una routine di callback tipizzata PI8042_KEYBOARD_ISR personalizza l'operazione dell'ISR della tastiera I8042prt.

Sintassi

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

Parametri

[in] IsrContext

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

[in] CurrentInput

Puntatore alla struttura KEYBOARD_INPUT_DATA di input costruita dall'ISR.

[in] CurrentOutput

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

[in] StatusByte

Specifica il byte di stato letto dalla porta di I/O 60 quando si verifica un interrupt.

[in] Byte

Specifica il byte di dati letto dalla porta di I/O 64 quando si verifica un interrupt.

[out] ContinueProcessing

Specifica che, se TRUE, l'elaborazione nella tastiera I8042prt ISR continuerà al termine di questo callback. In caso contrario, l'elaborazione non continua.

[in] ScanState

Puntatore a un valore di enumerazione KEYBOARD_SCAN_STATE, che identifica lo stato di analisi della tastiera.

Valore restituito

Un callback PI8042_KEYBOARD_ISR restituisce TRUE se l'ISR della tastiera I8042prt deve continuare; in caso contrario, restituisce FALSE.

Osservazioni

Un callback PI8042_KEYBOARD_ISR non è necessario se l'operazione predefinita dell'ISR della tastiera I8042prt è sufficiente.

Un driver di filtro della tastiera di livello superiore fornito dal fornitore facoltativo può fornire un callback PI8042_KEYBOARD_ISR. L'ISR I8042prt chiama il callback dopo la convalida dell'interrupt e legge il codice di analisi.

Il callback PI8042_KEYBOARD_ISR viene eseguito in modalità kernel in irQL della tastiera I8042prt ISR.