CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT-Struktur (gpioclx.h)
Die CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT-Struktur enthält eine Anforderung für die Hardwareattribute des GPIO-Controllers (Universelle E/A).
Syntax
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;
Member
RequestType
Der Typ der angeforderten Attributinformationen. Dieser Member wird auf einen CLIENT_CONTROLLER_QUERY_SET_REQUEST_TYPE Enumerationswert festgelegt.
Size
Gibt die Größe der CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT-Struktur in Bytes an.
Flags
Eine Reihe von Flagbits, die zusätzliche Informationen zum Typ der Attributanforderung bereitstellen, die vom RequestType-Member angegeben wird. Für das Flags-Element sind derzeit keine Flags definiert.
BankPowerInformation
Eine Struktur, die Informationen zur GPIO-Bank enthält, deren Energieattribute angefordert werden.
BankPowerInformation.BankId
Der Bezeichner für eine Bank mit GPIO-Pins. Wenn M die Anzahl der Banken im GPIO-Controller ist, ist BankId eine ganze Zahl im Bereich von 0 bis M1. Die GPIO-Frameworkerweiterung (GpioClx) hat zuvor die Anzahl der Banken im Controller über die CLIENT_QueryControllerBasicInformation-Ereignisrückruffunktion abgerufen. Weitere Informationen finden Sie unter Hinweise in CLIENT_CONTROLLER_BASIC_INFORMATION.
BankInterruptBinding
Eine -Struktur, die Informationen zu den Interruptressourcen enthält, die dem GPIO-Controller zugewiesen sind.
BankInterruptBinding.ResourcesTranslated
Ein Handle für ein Frameworkressourcenlistenobjekt, das die übersetzten Hardwareressourcen identifiziert, die der Plug & Play-Manager dem Gerät zugewiesen hat.
BankInterruptBinding.ResourcesRaw
Ein Handle für ein Frameworkressourcenlistenobjekt, das die Rohhardwareressourcen identifiziert, die der Plug & Play-Manager dem Gerät zugewiesen hat.
BankInterruptBinding.TotalBanks
Die Anzahl der Banken im GPIO-Controller. Dieses Element gibt die erwartete Länge des BankInterruptBinding.ResourceMapping-Arrays in der aufruferseitig zugewiesenen CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT-Struktur an, wenn der Aufrufer einen Zeiger ungleich NULL auf diese Struktur bereitstellt.
ControllerFunctionBankMapping
Eine Struktur, die Informationen zu einer E/A-Steuerungsanforderung (IOCTL) enthält.
ControllerFunctionBankMapping.InputBuffer
Ein Zeiger auf den Eingabepuffer für die IOCTL.
ControllerFunctionBankMapping.InputBufferSize
Die Größe des Eingabepuffers für die IOCTL in Byte.
ControllerFunctionBankMapping.OutputBufferSize
Die Größe des Ausgabepuffers für die IOCTL in Bytes.
ControllerFunctionBankMapping.TotalBanks
Die Anzahl der Banken im GPIO-Controller. Dieser Member gibt die erwartete Länge des ControllerFunctionBankMapping.Mapping-Arrays in der aufruferseitig zugewiesenen CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT-Struktur an, wenn der Aufrufer einen Zeiger ungleich NULL auf diese Struktur bereitstellt.
Hinweise
Die unbenannte Union enthält Eingabeinformationen für die verschiedenen Typen von Attributanforderungen. Das RequestType-Element bestimmt, welcher Member dieser Union verwendet wird. Die folgende Tabelle zeigt den Union-Member, der jedem gültigen RequestType-Wert entspricht.
| RequestType-Wert | Union-Mitglied |
|---|---|
| QueryBankPowerInformation | BankPowerInformation |
| QueryBankInterruptBindingInformation | BankInterruptBinding |
| QueryControllerFunctionBankMappingInformation | ControllerFunctionBankMapping |
Der InputBuffer-Parameter der CLIENT_QuerySetControllerInformation-Funktion ist ein Zeiger auf eine CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT-Struktur .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt ab Windows 8. |
| Kopfzeile | gpioclx.h |