GPIO_MASK_INTERRUPT_PARAMETERS 構造体 (gpioclx.h)

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 コントローラーで使用することを目的としています。

要件

こちらもご覧ください

CLIENT_CONTROLLER_BASIC_INFORMATION

CLIENT_MaskInterrupts

CLIENT_QueryControllerBasicInformation