GPIO_DISABLE_INTERRUPT_PARAMETERS 構造体 (gpioclx.h)

GPIO_DISABLE_INTERRUPT_PARAMETERS構造体では、無効化する汎用 I/O (GPIO) 割り込みピンについて説明します。

構文

typedef struct _GPIO_DISABLE_INTERRUPT_PARAMETERS {
  BANK_ID                      BankId;
  PIN_NUMBER                   PinNumber;
  GPIO_DISABLE_INTERRUPT_FLAGS Flags;
} GPIO_DISABLE_INTERRUPT_PARAMETERS, *PGPIO_DISABLE_INTERRUPT_PARAMETERS;

メンバー

BankId

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

PinNumber

銀行相対ピン番号。 N がこのバンクの番号ピンの場合、 PinNumber は 0 から N - 1 の範囲の整数です。 GpioClx は以前、 CLIENT_QueryControllerBasicInformation イベント コールバック関数から各バンクのピン数を取得しました。 詳細については、CLIENT_CONTROLLER_BASIC_INFORMATIONの NumberOfPinsPerBank メンバーの説明を参照してください。

Flags

割り込み/無効化操作を制御するフラグのセット。 RetryDisableOnFailure フラグ ビットは、同じピンを無効にする前のCLIENT_DisableInterrupt呼び出しが失敗したことを示します。 詳細については、「解説」を参照してください。

注釈

CLIENT_DisableInterrupt イベント コールバック関数の DisableParameters パラメーターは、呼び出し元によって割り当てられたGPIO_DISABLE_INTERRUPT_PARAMETERS構造体へのポインターです。

メモリ マップ GPIO コントローラーの CLIENT_DisableInterrupt 関数は、割り込みを無効にすることで常に成功することが期待されます。 ただし、メモリ マップされていないコントローラーの CLIENT_DisableInterrupt 関数は、割り込みを無効にするためにコントローラーに I/O 要求を送信する必要があり、この要求は失敗する可能性があります。 要求で割り込みを無効にできない場合、関数はエラー状態コードを返す必要があります。

CLIENT_DisableInterrupt呼び出しが失敗した後、GpioClx は呼び出しを 1 回以上再試行する可能性があります。 再試行のたびに、GpioClx は RetryDisableOnFailure フラグを設定して、前の呼び出しが失敗したことを示します。 CLIENT_DisableInterrupt関数は、割り込みを無効にする次の試行が成功する可能性を高めるために追加の手順を実行することで、このフラグに応答する可能性があります。

要件

要件	値
サポートされている最小のクライアント	Windows 8 以降でサポートされています。
Header	gpioclx.h

こちらもご覧ください

CLIENT_CONTROLLER_BASIC_INFORMATION

CLIENT_DisableInterrupt

CLIENT_QueryControllerBasicInformation