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 allgemeinen I/O-Controllers (GPIO).
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;
Angehörige
RequestType
Der Typ von Attributinformationen, die angefordert werden. Dieses Element 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 Member sind derzeit keine Flags definiert.
BankPowerInformation
Eine Struktur, die Informationen über die GPIO-Bank enthält, deren Leistungsattribute angefordert werden.
BankPowerInformation.BankId
Der Bezeichner für eine Bank von GPIO-Pins. Wenn M die Anzahl der Banken im GPIO-Controller ist, ist BankId eine ganze Zahl im Bereich von 0 bis M-1. Die GPIO-Framework-Erweiterung (GpioClx) hat zuvor die Anzahl der Banken im Controller aus der CLIENT_QueryControllerBasicInformation Ereignisrückruffunktion abgerufen. Weitere Informationen finden Sie in den Hinweisen 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 zu einem Framework-Ressourcenlistenobjekt, das die übersetzten Hardwareressourcen identifiziert, die der Plug- und Play-Manager dem Gerät zugewiesen hat.
BankInterruptBinding.ResourcesRaw
Ein Handle zu einem Framework-Ressourcenlistenobjekt, das die rohen Hardwareressourcen identifiziert, die der Plug- und 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 Array in der vom Aufrufer zugewiesenen CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT Struktur an, wenn der Aufrufer einen Nicht-NULL-Zeiger für diese Struktur bereitstellt.
ControllerFunctionBankMapping
Eine Struktur, die Informationen zu einer E/A-Kontrollanforderung (IOCTL) enthält.
ControllerFunctionBankMapping.InputBuffer
Ein Zeiger auf den Eingabepuffer für die IOCTL.
ControllerFunctionBankMapping.InputBufferSize
Die Größe des Eingabepuffers für das IOCTL in Bytes.
ControllerFunctionBankMapping.OutputBufferSize
Die Größe des Ausgabepuffers für die IOCTL in Bytes.
ControllerFunctionBankMapping.TotalBanks
Die Anzahl der Banken im GPIO-Controller. Dieses Element gibt die erwartete Länge der ControllerFunctionBankMapping.Mapping Array in der vom Aufrufer zugewiesenen CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT Struktur an, wenn der Aufrufer einen Nicht-NULL-Zeiger für diese Struktur bereitstellt.
Bemerkungen
Die unbenannte Union enthält Eingabeinformationen für die verschiedenen Typen von Attributanforderungen. Das RequestType Member bestimmt, welches Mitglied dieser Union verwendet wird. Die folgende Tabelle zeigt das Union-Mitglied, das 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 |
|---|---|
| mindestens unterstützte Client- | Wird ab Windows 8 unterstützt. |
| Header- | gpioclx.h |