GPIO_DISCONNECT_IO_PINS_PARAMETERS 構造体 (gpioclx.h)
GPIO_DISCONNECT_IO_PINS_PARAMETERS構造では、切断される汎用 I/O (GPIO) ピンのセットについて説明します。
構文
typedef struct _GPIO_DISCONNECT_IO_PINS_PARAMETERS {
BANK_ID BankId;
PPIN_NUMBER PinNumberTable;
ULONG PinCount;
GPIO_CONNECT_IO_PINS_MODE DisconnectMode;
GPIO_DISCONNECT_IO_PINS_FLAGS DisconnectFlags;
} GPIO_DISCONNECT_IO_PINS_PARAMETERS, *PGPIO_DISCONNECT_IO_PINS_PARAMETERS;
メンバー
BankId
GPIO ピンを含む銀行の識別子。 M が GPIO コントローラー内のバンクの数の場合、 BankId は 0 ~ M – 1 の範囲の整数です。 GPIO フレームワーク拡張機能 (GpioClx) は、以前に 、CLIENT_QueryControllerBasicInformation イベント コールバック関数からコントローラー内のバンクの数を取得しました。 詳細については、「 CLIENT_CONTROLLER_BASIC_INFORMATIONの解説」を参照してください。
PinNumberTable
PIN_NUMBER値の配列へのポインター。 各配列要素は、切断する GPIO ピンの数を指定します。 GPIO コントローラーに N 個のピンがある場合、ピンには 0 ~ N – 1 の番号が付きます。 この配列内の要素の数は、 PinCount メンバーによって指定されます。
PinCount
PinNumberTable 配列内の要素の数。
DisconnectMode
閉じている接続の GPIO ピンが入力または出力として構成されているかどうか。 このメンバーの値は、読み取り専用接続の 場合は ConnectModeInput 、書き込み専用接続の 場合は ConnectModeOutput 、読み取り/書き込み接続の場合は (ConnectModeInput | ConnectModeOutput) です。 詳細については、「 GPIO_CONNECT_IO_PINS_MODE」を参照してください。
DisconnectFlags
GPIO ピンを閉じた後の構成方法を制御するフラグのセット。 PreserveConfiguration フラグ ビットが設定されている場合、GPIO コントローラー ドライバーは、切断された後もピンの構成を保持します。 詳細については、「解説」を参照してください。
注釈
CLIENT_DisconnectIoPins イベント コールバック ルーチンの DisconnectParameters パラメーターは、GPIO_CONNECT_IO_PINS_PARAMETERS構造体へのポインターです。
既定では、GPIO I/O ピンが切断されると、GPIO コントローラー ドライバーはプラットフォーム固有の初期状態でピンを構成します。 ピンは通常、バッテリの負荷を軽減するために低電力状態で構成されます。 ただし、 PreserveConfiguration フラグを使用して、この既定の動作をオーバーライドできます。 フラグは、切断されている I/O ピンの構成を保持するように GPIO コントローラー ドライバーに指示します。
たとえば、周辺機器ドライバーは、出力として構成されている GPIO I/O ピンへの論理接続を開き、ビット値 1 をピンに書き込む場合があります。 PreserveConfiguration フラグを使用すると、ドライバーはピンの出力レベルを変更せずに接続を閉じます。 その後、ドライバーがピンの出力レベルを 1 から 0 に変更する必要がある場合、ドライバーはピンへの新しい接続を開きます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 以降でサポートされています。 |
| Header | gpioclx.h |
こちらもご覧ください
CLIENT_CONTROLLER_BASIC_INFORMATION