GPIO_CONNECT_IO_PINS_PARAMETERS構造体 (gpioclx.h)

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

GPIO_CONNECT_IO_PINS_PARAMETERS構造は、汎用 I/O (GPIO) ピンのセットへの論理接続を記述し、これらのピンをデータ入力または出力として構成するかどうかを指定します。

構文

typedef struct _GPIO_CONNECT_IO_PINS_PARAMETERS {
  BANK_ID                    BankId;
  PPIN_NUMBER                PinNumberTable;
  USHORT                     PinCount;
  GPIO_CONNECT_IO_PINS_MODE  ConnectMode;
  UCHAR                      PullConfiguration;
  USHORT                     DebounceTimeout;
  USHORT                     DriveStrength;
  PVOID                      VendorData;
  ULONG                      VendorDataLength;
  GPIO_CONNECT_IO_PINS_FLAGS ConnectFlags;
} GPIO_CONNECT_IO_PINS_PARAMETERS, *PGPIO_CONNECT_IO_PINS_PARAMETERS;

メンバー

BankId

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

PinNumberTable

PIN_NUMBER値の配列へのポインター。各配列要素は、接続する GPIO ピンの数を指定します。 N がこのバンク内のピンの数である場合、ピンには 0 ~ N – 1 の番号が付きます。この配列内の要素の数は、 PinCount メンバーによって指定されます。

PinCount

PinNumberTable 配列内の要素の数。

ConnectMode

新しい接続の GPIO ピンを入力または出力として構成する必要があるかどうか。このパラメーターの値は、読み取り専用接続の 場合は ConnectModeInput 、書き込み専用接続の 場合は ConnectModeOutput 、読み取り/書き込み接続の場合は (ConnectModeInput | ConnectModeOutput) です。詳細については、「 GPIO_CONNECT_IO_PINS_MODE」を参照してください。

PullConfiguration

GPIO ピンをプルするか、プルダウンするか。このメンバーは、通常、次のシステム定義定数のいずれかに設定されます。

GPIO_PIN_PULL_CONFIGURATION_PULLDEFAULT
GPIO_PIN_PULL_CONFIGURATION_PULLUP
GPIO_PIN_PULL_CONFIGURATION_PULLDOWN
GPIO_PIN_PULL_CONFIGURATION_PULLNONE

これらの定数のいずれもピン構成を適切に記述しない場合は、このメンバーを 128 から 255 の範囲のベンダー定義の定数に設定できます。これらの定数の詳細については、「 GPIO_PIN_PULL_CONFIGURATION_XXX」を参照してください。

DebounceTimeout

デバウンス時間 (10 マイクロ秒単位)。たとえば、5.84 ミリ秒のデバウンス時間は 584 として指定されます。機械式スイッチによって入力信号が生成されると、スイッチの電源が入ったりオフになった後に、スイッチ内の金属接点が短時間バウンスする傾向があります。デバウンス時間は、信号が有効な高レベルまたは低レベルとして解釈される前に、入力信号のレベルが安定している必要がある最小時間です。

DriveStrength

GPIO ピンの駆動強度 (10 マイクロアンペア単位)。たとえば、1.21 ミリアンペアの駆動強度は 121 と指定されます。

VendorData

ハードウェアプラットフォームの ACPI ファームウェアから取得されたベンダー固有のデータを含む呼び出し元によって割り当てられたバッファーへのポインター。このデータは、周辺機器と GPIO コントローラー上の GPIO ピンのセットとの間のデータ I/O 接続を記述する GPIO リソース記述子の VendorData フィールドからコピーされます。このメンバーは省略可能であり、ファームウェアがこの接続のベンダー固有のデータを提供しない場合は NULL に設定されます。

VendorDataLength

VendorData メンバーが指すデータバッファーのサイズ (バイト単位)。 VendorData が NULL の場合、VendorDataLength は 0 に設定されます。

ConnectFlags

GPIO ピンの構成を制御するフラグのセット。現在、このメンバーに対してフラグは定義されていません。