次の方法で共有


CLIENT_CONTROLLER_BASIC_INFORMATION構造体 (gpioclx.h)

CLIENT_CONTROLLER_BASIC_INFORMATION 構造体には、汎用 I/O (GPIO) コントローラーのハードウェア属性と構成情報が含まれています。

構文

typedef struct _CLIENT_CONTROLLER_BASIC_INFORMATION {
  USHORT                     Version;
  USHORT                     Size;
  USHORT                     TotalPins;
  UCHAR                      NumberOfPinsPerBank;
  ULONG                      DeviceIdleTimeout;
  CONTROLLER_ATTRIBUTE_FLAGS Flags;
} CLIENT_CONTROLLER_BASIC_INFORMATION, *PCLIENT_CONTROLLER_BASIC_INFORMATION;

メンバーズ

Version

この構造体のバージョン番号。 このメンバーを Gpioclx.h ヘッダー ファイルで定義されている GPIO_CONTROLLER_BASIC_INFORMATION_VERSIONに設定します。

Size

この構造体のサイズ (バイト単位)。 このメンバーを sizeof(CLIENT_CONTROLLER_BASIC_INFORMATION) に設定します。

TotalPins

GPIO コントローラーのピンの数。 ピンが複数のバンクに分割されている場合、このメンバーは GPIO コントローラー内のすべてのバンクの合計ピン数を指定します。

NumberOfPinsPerBank

各バンクの GPIO ピンの数。 各バンクの最大ピン数は 64 です。 GPIO コントローラーのピンは、1 つ以上のバンクに分割されます。 各バンクには、このパラメーターで指定されたピンの数が含まれていますが、最後のバンクを除く可能性があります。 詳細については、「解説」を参照してください。

DeviceIdleTimeout

GPIO コントローラーが D3 電源状態をサポートしている場合のアイドル タイムアウト間隔 (ミリ秒単位)。 タイムアウト間隔は、コントローラーがアイドル状態になった後、GPIO コントローラーが D0 状態のままになる最小時間です。 タイムアウト間隔の有効期限が切れると、電源マネージャーはコントローラーに D3 状態への切り替えを要求する場合があります。

Flags

GPIO コントローラーのハードウェア属性を指定するフラグのセット。 このメンバーは、すべてのゼロまたは次のフラグ ビットのビットごとの OR の組み合わせに設定できます。

  • MemoryMappedController
  • ActiveInterruptsAutoClearOnRead
  • FormatIoRequestsAsMasks
  • DeviceIdlePowerMgmtSupported
  • BankIdlePowerMgmtSupported
  • EmulateDebouncing
  • EmulateActiveBoth
詳細については、CONTROLLER_ATTRIBUTE_FLAGSを参照してください。

備考

CLIENT_QueryControllerBasicInformation イベント コールバック関数は、CLIENT_CONTROLLER_BASIC_INFORMATION 構造体を使用して、GPIO コントローラーに関するデバイス固有の情報を GPIO フレームワーク拡張機能 (GpioClx) に渡します。

GPIO コントローラー ドライバーは、GPIO コントローラー デバイスのピンをいくつかのバンクに分割できます。 N がコントローラ内のバンクの数である場合、バンクには 0 から N – 1 の番号が付けられます。 最後のバンク (つまり、銀行番号 N から 1) を除くすべての銀行には、NumberOfPinsPerBank メンバーで指定されたピンの数を含める必要があります。 最後のバンクには、NumberOfPinsPerBank 1 つから任意の数のピンを持つことができます。

GpioClx は、TotalPins および NumberOfPinsPerBank メンバーの値から、GPIO コントローラー内のバンクの合計数 決定します。 GpioClx では、次の整数式を使用してバンクの合計数を計算します。

TotalPinsNumberOfPinsPerBank NumberOfPinsPerBank 通常、GPIO コントローラー デバイス内のバンクは、同じデバイス内の他のバンクとは別にオンとオフを切り替えることができます。 したがって、アイドル状態のバンクをオフにすることで、電力を節約できます。

必要条件

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

関連項目

CLIENT_QueryControllerBasicInformation

CONTROLLER_ATTRIBUTE_FLAGS