PI8042_MOUSE_ISR コールバック関数 (ntdd8042.h)

[アーティクル]
02/29/2024

PI8042_MOUSE_ISR型コールバックルーチンは、I8042prt マウス ISR の操作をカスタマイズします。

構文

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

パラメーター

[in] IsrContext

このコールバックを提供するドライバーのフィルターデバイスオブジェクトへのポインター。

[in] CurrentInput

ISR によって構築される入力 MOUSE_INPUT_DATA 構造体へのポインター。

[in] CurrentOutput

ハードウェアデバイスに書き込まれるバイト配列を指定する、 OUTPUT_PACKET 構造体へのポインター。

[in] StatusByte

割り込みが発生したときに I/O ポート 60 から読み取る状態バイトを指定します。

[in] Byte

割り込みが発生したときに I/O ポート 64 から読み取るデータバイトを指定します。

[in, out] ContinueProcessing

TRUE の場合、このコールバックが完了した後も、I8042prt マウス ISR での処理を続行することを指定します。それ以外の場合、処理は続行されません。

[in] MouseState

マウス入力の状態を識別する MOUSE_STATE 列挙値へのポインター。

[in] ResetSubState

MOUSE_RESET_SUBSTATE列挙値へのポインター。これは、マウスのリセットサブ状態を識別します。「解説」を参照してください。

戻り値

I8042prt マウス ISR を続行する必要がある場合、PI8042_MOUSE_ISR コールバックは TRUE を 返します。それ以外の場合は FALSE を返します。

注釈

I8042prt マウス ISR の既定の操作で十分な場合は、PI8042_MOUSE_ISRコールバックは必要ありません。

上位レベルのキーボードフィルタードライバーは、マウス ISR コールバックを提供できます。 I8042prt マウス ISR が割り込みを検証した後、マウス ISR コールバックを呼び出します。

マウスをリセットするために、I8042prt は一連の操作サブ状態を通過し、それぞれがMOUSE_RESET_SUBSTATE列挙値によって識別されます。 I8042prt がマウスと対応するマウスリセットサブ状態をリセットする方法の詳細については、ntdd8042.h のMOUSE_RESET_SUBSTATEのドキュメントを参照してください。

PI8042_MOUSE_ISR コールバックは、I8042prt マウス ISR の IRQL でカーネルモードで実行されます。