CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT結構 (gpioclx.h)
CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT 結構包含 GPIO 架構延伸模組 (GpioClx) 所要求的一組一般用途 I/O (GPIO) 控制器屬性。
語法
typedef struct _CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT {
USHORT Version;
USHORT Size;
union {
CLIENT_QUERY_BANK_POWER_INFORMATION_OUTPUT BankPowerInformation;
struct {
ULONG ResourceMapping[ANYSIZE_ARRAY];
} BankInterruptBinding;
struct {
BOOLEAN Mapping[ANYSIZE_ARRAY];
} ControllerFunctionBankMapping;
};
} CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT, *PCLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT;
成員
Version
指定這個結構的版本號碼。
Size
指定這個 結構的大小,以位元組為單位。
BankPowerInformation
CLIENT_QUERY_BANK_POWER_INFORMATION_OUTPUT 結構,其中包含由對應 CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT 結構之 BankPowerInformation.BankId 成員所識別之 GPIO 銀行的電源屬性。
BankInterruptBinding
結構,包含中斷資源系結至 GPIO 銀行的相關信息。
BankInterruptBinding.ResourceMapping[ANYSIZE_ARRAY]
中斷資源編號的陣列。 陣列中的元素數目等於 GPIO 銀行的數目。 如果 N 是 GPIO 控制器中的銀行數目,則銀行編號為 0 到 N–1。 數位的元素 0 包含系結至銀行 0 的插斷資源編號,元素 1 包含系結至銀行 1 的中斷資源編號,依此等。 不能有一個以上的中斷資源系結至 GPIO 銀行,但兩個或多個銀行可能會共用中斷資源。 如果銀行未系結至中斷資源,對應的陣列元素會設定為 GPIO_BANK_INTERRUPT_BINDING_RESERVED_INDEX (0xffff)。
中斷資源是由其資源編號所識別,這是 ResourcesTranslated 或 ResourcesRaw 資源清單中的資源索引,BankInterruptBindingCLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT 結構的成員。 如果清單包含 M 資源,則資源編號為 0 到 M-1。 只有對應至資源清單中中斷資源的資源編號才會出現在 ResourceMapping 陣列中。
ControllerFunctionBankMapping
結構,其中包含必須位於 F0(完全開啟)電源狀態以處理 I/O 控制要求 (IOCTL) 之 GPIO 銀行的相關信息。
ControllerFunctionBankMapping.Mapping[ANYSIZE_ARRAY]
BOOLEAN 值的陣列,表示必要的 F0 電源狀態與 GPIO 銀行的對應。 陣列中的元素數目等於 GPIO 銀行的數目。 如果 N 是 GPIO 控制器中的銀行數目,則銀行編號為 0 到 N–1。 數位的元素 0 包含銀行 0 的對應、元素 1 包含銀行 1 的對應等等。 如果元素 TRUE,對應的 GPIO 銀行必須處於 F0 電源狀態,才能處理 IOCTL。 如果元素 FALSE,則不需要對應的銀行處於 F0 電源狀態。
言論
未命名的等位包含各種屬性要求的輸出資訊。 對應 CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT 結構的 RequestType 成員會決定使用這些成員的哪一個。
CLIENT_QuerySetControllerInformation 函式的選擇性 OutputBuffer 參數是呼叫端配置 CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT 結構的指標。 如果 outputBuffer 為非 NULL,函式會將要求的屬性資訊寫入這個結構。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows 8 開始支援。 |
標頭 | gpioclx.h |