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 以降でサポートされています。 |
| ヘッダー | gpioclx.h |
関連項目
CLIENT_CONTROLLER_BASIC_INFORMATION