Freigeben über

CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT-Struktur (gpioclx.h)

  • Artikel

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

Weitere Informationen