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 値 | 組合員 |
|---|---|
| QueryBankPowerInformation | BankPowerInformation |
| QueryBankInterruptBindingInformation | BankInterruptBinding |
| QueryControllerFunctionBankMappingInformation | ControllerFunctionBankMapping |
CLIENT_QuerySetControllerInformation 関数の InputBuffer パラメーターは、CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT 構造体へのポインターです。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 8 以降でサポートされています。 |
| ヘッダー | gpioclx.h |