GPIO_DISCONNECT_IO_PINS_PARAMETERS Struktur (gpioclx.h)
Die GPIO_DISCONNECT_IO_PINS_PARAMETERS Struktur beschreibt eine Reihe von allgemeinen I/O-Pins (GPIO), die getrennt werden sollen.
Syntax
typedef struct _GPIO_DISCONNECT_IO_PINS_PARAMETERS {
BANK_ID BankId;
PPIN_NUMBER PinNumberTable;
ULONG PinCount;
GPIO_CONNECT_IO_PINS_MODE DisconnectMode;
GPIO_DISCONNECT_IO_PINS_FLAGS DisconnectFlags;
} GPIO_DISCONNECT_IO_PINS_PARAMETERS, *PGPIO_DISCONNECT_IO_PINS_PARAMETERS;
Angehörige
BankId
Der Bezeichner für die Bank, die die GPIO-Pins enthält. 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.
PinNumberTable
Ein Zeiger auf ein Array mit PIN_NUMBER Werten. Jedes Arrayelement gibt die Anzahl eines GPIO-Pins an, von dem die Verbindung getrennt werden soll. Wenn der GPIO-Controller N-Pins enthält, werden die Pins 0 bis N-1 nummeriert. Die Anzahl der Elemente in diesem Array wird durch das PinCount Member angegeben.
PinCount
Die Anzahl der Elemente im PinNumberTable Arrays.
DisconnectMode
Gibt an, ob die GPIO-Pins in der verbindung, die geschlossen wird, als Eingaben oder als Ausgaben konfiguriert werden. Der Wert dieses Elements ist ConnectModeInput für eine schreibgeschützte Verbindung, ConnectModeOutput für eine schreibgeschützte Verbindung oder (ConnectModeInput | ConnectModeOutput) für eine Lese-/Schreibverbindung. Weitere Informationen finden Sie unter GPIO_CONNECT_IO_PINS_MODE.
DisconnectFlags
Eine Reihe von Flags, die steuern, wie die GPIO-Pins nach dem Schließen konfiguriert werden sollen. Wenn die PreserveConfiguration Flag-Bit festgelegt ist, behält der GPIO-Controllertreiber die Konfiguration der Pins bei, nachdem sie getrennt wurden. Weitere Informationen finden Sie in den Hinweisen.
Bemerkungen
Die DisconnectParameters Parameter für die CLIENT_DisconnectIoPins Ereignisrückrufroutine ist ein Zeiger auf eine GPIO_CONNECT_IO_PINS_PARAMETERS Struktur.
Wenn ein GPIO-E/A-Pin getrennt wird, konfiguriert der GPIO-Controllertreiber standardmäßig den Pin in einem plattformspezifischen Anfangszustand. Der Pin ist in der Regel in einem Energiesparzustand konfiguriert, um die Last des Akkus zu reduzieren. Das PreserveConfiguration Flag kann jedoch verwendet werden, um dieses Standardverhalten außer Kraft zu setzen. Das Flag weist den GPIO-Controllertreiber an, die Konfiguration der I/O-Pins beizubehalten, die getrennt werden.
Ein Peripheriegerätetreiber kann z. B. eine logische Verbindung mit einem GPIO-E/A-Pin öffnen, der als Ausgabe konfiguriert ist, und dann einen Bitwert von 1 an den Pin schreiben. Mit dem PreserveConfiguration--Flag kann der Treiber die Verbindung schließen, ohne die Ausgabestufe des Pins zu ändern. Wenn der Treiber später den Ausgabewert des Pins von 1 auf 0 ändern muss, öffnet der Treiber eine neue Verbindung mit dem Pin.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Wird ab Windows 8 unterstützt. |
| Header- | gpioclx.h |
Siehe auch
CLIENT_CONTROLLER_BASIC_INFORMATION