CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT構造体 (gpioclx.h)
CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT構造体には、汎用 I/O (GPIO) コントローラーのハードウェア属性に対する要求が含まれています。
構文
typedef struct _CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT {
CLIENT_CONTROLLER_QUERY_SET_REQUEST_TYPE RequestType;
USHORT Size;
ULONG Flags;
union {
struct {
BANK_ID BankId;
} BankPowerInformation;
struct {
WDFCMRESLIST ResourcesTranslated;
WDFCMRESLIST ResourcesRaw;
USHORT TotalBanks;
} BankInterruptBinding;
struct {
PVOID InputBuffer;
SIZE_T InputBufferSize;
SIZE_T OutputBufferSize;
USHORT TotalBanks;
} ControllerFunctionBankMapping;
};
} CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT, *PCLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT;
メンバー
RequestType
要求される属性情報の種類。 このメンバーは、 CLIENT_CONTROLLER_QUERY_SET_REQUEST_TYPE 列挙値に設定されます。
Size
CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT構造体のサイズをバイト単位で指定します。
Flags
RequestType メンバーによって示される属性要求の種類に関する追加情報を提供するフラグ ビットのセット。 現在、Flags メンバーに対して フラグ は定義されていません。
BankPowerInformation
電源属性が要求されている GPIO バンクに関する情報を含む構造体。
BankPowerInformation.BankId
GPIO ピンのバンクの識別子。 M が GPIO コントローラー内のバンクの数の場合、 BankId は 0 から M – 1 の範囲の整数です。 GPIO フレームワーク拡張機能 (GpioClx) は以前、 CLIENT_QueryControllerBasicInformation イベント コールバック関数からコントローラー内のバンクの数を取得しました。 詳細については、「 CLIENT_CONTROLLER_BASIC_INFORMATIONの備考」を参照してください。
BankInterruptBinding
GPIO コントローラーに割り当てられている割り込みリソースに関する情報を含む構造体。
BankInterruptBinding.ResourcesTranslated
プラグ アンド プレイ マネージャーがデバイスに割り当てた変換されたハードウェア リソースを識別するフレームワーク リソースリスト オブジェクトへのハンドル。
BankInterruptBinding.ResourcesRaw
プラグ アンド プレイ マネージャーがデバイスに割り当てた未加工のハードウェア リソースを識別するフレームワーク リソースリスト オブジェクトへのハンドル。
BankInterruptBinding.TotalBanks
GPIO コントローラー内のバンクの数。 呼び出し元がこの構造体に NULL 以外のポインターを提供する場合、このメンバーは、呼び出し元によって割り当てられたCLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT構造体内の BankInterruptBinding.ResourceMapping 配列の予想される長さを示します。
ControllerFunctionBankMapping
I/O 制御要求 (IOCTL) に関する情報を含む構造体。
ControllerFunctionBankMapping.InputBuffer
IOCTL の入力バッファーへのポインター。
ControllerFunctionBankMapping.InputBufferSize
IOCTL の入力バッファーのサイズ (バイト単位)。
ControllerFunctionBankMapping.OutputBufferSize
IOCTL の出力バッファーのサイズ (バイト単位)。
ControllerFunctionBankMapping.TotalBanks
GPIO コントローラー内のバンクの数。 呼び出し元がこの構造体に NULL 以外のポインターを提供する場合、このメンバーは、呼び出し元によって割り当てられたCLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT構造体内の ControllerFunctionBankMapping.Mapping 配列の予想される長さを示します。
注釈
名前のない共用体には、さまざまな種類の属性要求の入力情報が含まれています。 RequestType メンバーは、この共用体のどのメンバーを使用するかを決定します。 次の表は、有効な 各 RequestType 値に対応する共用体メンバーを示しています。
| RequestType 値 | Union メンバー |
|---|---|
| QueryBankPowerInformation | BankPowerInformation |
| QueryBankInterruptBindingInformation | BankInterruptBinding |
| QueryControllerFunctionBankMappingInformation | ControllerFunctionBankMapping |
CLIENT_QuerySetControllerInformation関数の InputBuffer パラメーターは、CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT構造体へのポインターです。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 以降でサポートされています。 |
| Header | gpioclx.h |