GPIO_MASK_INTERRUPT_PARAMETERS 構造体 (gpioclx.h)

[アーティクル]
08/07/2023

GPIO_MASK_INTERRUPT_PARAMETERS構造体は、マスクする汎用 I/O (GPIO) 割り込みピンのセットを記述します。

構文

typedef struct _GPIO_MASK_INTERRUPT_PARAMETERS {
  BANK_ID BankId;
  ULONG64 PinMask;
  ULONG64 FailedMask;
} GPIO_MASK_INTERRUPT_PARAMETERS, *PGPIO_MASK_INTERRUPT_PARAMETERS;

メンバー

BankId

マスクする割り込みを含む GPIO ピンのバンクの識別子。 N が GPIO コントローラー内のバンクの数の場合、 BankId は 0 から N から 1 の範囲の整数です。 GPIO フレームワーク拡張機能 (GpioClx) は、以前に、CLIENT_QueryControllerBasicInformation イベントコールバック関数からコントローラー内のバンクの数を取得しました。詳細については、「 CLIENT_CONTROLLER_BASIC_INFORMATIONの解説」を参照してください。

PinMask

指定したバンクでマスクする割り込みピンを示す 64 ビットマスク。このマスクは、割り込み要求入力として構成されている GPIO ピンにのみ影響します。マスクのビットが 1 に設定されている場合、マスクされるピンが識別されます。マスク内の他のすべてのビットは 0 です。 N がこのバンク内のピンの数である場合、ピンには 0 ~ N – 1 の番号が付きます。マスク内のビット 0 (最下位ビット) はピン 0、ビット 1 はピン 1 などを表します。

FailedMask

マスクできなかった GPIO ピンを識別する 64 ビットマスク。 GPIO コントローラードライバーが PinMask メンバーに示されているビットをマスクできない場合、ドライバーは FailedMask メンバー内の対応するビットを設定して、このエラーをマークします。 PinMask で指定されたすべてのピンが正常にマスクされた場合、ドライバーは FailedMask を 0 に設定します。詳細については、「解説」を参照してください。

注釈

CLIENT_MaskInterrupts イベントコールバック関数の MaskParameters パラメーターは、呼び出し元によって割り当てられたGPIO_MASK_INTERRUPT_PARAMETERS構造体へのポインターです。この関数は、割り込み入力として構成され、指定された GPIO ピンのバンクの一部である GPIO ピンにのみ影響します。

メモリマップトレジスタを持つ GPIO コントローラーは、割り込みマスクを要求された値に設定する場合に常に成功することが期待されます。 FailedMask メンバーは、主にメモリマップされていない GPIO コントローラーで使用することを目的としています。