GPIO_CONNECT_IO_PINS_PARAMETERS-Struktur (gpioclx.h)
Die GPIO_CONNECT_IO_PINS_PARAMETERS-Struktur beschreibt eine logische Verbindung mit einer Reihe von GPIO-Pins (General Purpose E/O) und gibt an, ob diese Pins als Dateneingaben oder -ausgaben konfiguriert werden sollen.
Syntax
typedef struct _GPIO_CONNECT_IO_PINS_PARAMETERS {
BANK_ID BankId;
PPIN_NUMBER PinNumberTable;
USHORT PinCount;
GPIO_CONNECT_IO_PINS_MODE ConnectMode;
UCHAR PullConfiguration;
USHORT DebounceTimeout;
USHORT DriveStrength;
PVOID VendorData;
ULONG VendorDataLength;
GPIO_CONNECT_IO_PINS_FLAGS ConnectFlags;
} GPIO_CONNECT_IO_PINS_PARAMETERS, *PGPIO_CONNECT_IO_PINS_PARAMETERS;
Member
BankId
Der Bezeichner für die Bank, die die GPIO-Pins enthält. Wenn M die Anzahl der Banken im GPIO-Controller ist, ist Die BankId eine ganze Zahl im Bereich von 0 bis M–1. Die GPIO-Frameworkerweiterung (GpioClx) hat zuvor die Anzahl der Banken im Controller aus der CLIENT_QueryControllerBasicInformation Ereignisrückruffunktion abgerufen. Weitere Informationen finden Sie unter Hinweise in CLIENT_CONTROLLER_BASIC_INFORMATION.
PinNumberTable
Ein Zeiger auf ein Array von PIN_NUMBER Werten. Jedes Arrayelement gibt die Anzahl eines GPIO-Pins an, mit dem eine Verbindung hergestellt werden soll. Wenn N die Anzahl der Pins in dieser Bank ist, sind die Pins 0 bis N–1 nummeriert. Die Anzahl der Elemente in diesem Array wird vom PinCount-Element angegeben.
PinCount
Die Anzahl der Elemente im PinNumberTable-Array .
ConnectMode
Gibt an, ob die GPIO-Pins in der neuen Verbindung als Eingaben oder als Ausgaben konfiguriert werden sollen. Der Wert dieses Parameters ist ConnectModeInput für eine schreibgeschützte Verbindung, ConnectModeOutput für eine schreibgeschützte Verbindung und (ConnectModeInput | ConnectModeModeOutput) für eine Lese-/Schreibverbindung. Weitere Informationen finden Sie unter GPIO_CONNECT_IO_PINS_MODE.
PullConfiguration
Gibt an, ob der GPIO-Pin nach oben oder nach unten gezogen wird. Dieser Member ist in der Regel auf eine der folgenden systemdefinierte Konstanten festgelegt:
- GPIO_PIN_PULL_CONFIGURATION_PULLDEFAULT
- GPIO_PIN_PULL_CONFIGURATION_PULLUP
- GPIO_PIN_PULL_CONFIGURATION_PULLDOWN
- GPIO_PIN_PULL_CONFIGURATION_PULLNONE
DebounceTimeout
Die Debouncezeit in Einheiten von 10 Mikrosekunden. Beispielsweise wird eine Debouncezeit von 5,84 Millisekunden als 584 angegeben. Wenn durch einen mechanischen Schalter ein Eingangssignal generiert wird, neigt der Metallkontakt im Schalter dazu, nach dem Ein- oder Ausschalten des Schalters für eine kurze Zeit zu springen. Die Debouncezeit ist die mindeste Zeit, in der der Pegel des Eingangssignals stabil bleiben muss, bevor das Signal als gültiger hoher oder niedriger Pegel interpretiert werden kann.
DriveStrength
Die Antriebsstärke des GPIO-Pins in Einheiten von 10 Mikroamperen. Beispielsweise wird eine Antriebsstärke von 1,21 Milliampere als 121 angegeben.
VendorData
Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der herstellerspezifische Daten enthält, die von der ACPI-Firmware für die Hardwareplattform abgerufen wurden. Diese Daten werden aus dem Feld VendorData des GPIO-Ressourcendeskriptors kopiert, der die Daten-E/A-Verbindung zwischen dem Peripheriegerät und einer Reihe von GPIO-Pins auf dem GPIO-Controller beschreibt. Dieser Member ist optional und auf NULL festgelegt, wenn die Firmware keine herstellerspezifischen Daten für diese Verbindung liefert.
VendorDataLength
Die Größe des Datenpuffers in Bytes, auf die das VendorData-Element verweist. Wenn VendorData NULL ist, wird VendorDataLength auf 0 festgelegt.
ConnectFlags
Eine Gruppe von Flags, die die Konfiguration der GPIO-Pins steuern. Für dieses Element sind derzeit keine Flags definiert.
Hinweise
Der ClientParameters-Parameter auf die CLIENT_ConnectIoPins Ereignisrückrufroutine ist ein Zeiger auf eine GPIO_CONNECT_IO_PINS_PARAMETERS Struktur.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Wird ab Windows 8 unterstützt. |
| Kopfzeile | gpioclx.h |
Weitere Informationen
CLIENT_CONTROLLER_BASIC_INFORMATION