GPIO_DISCONNECT_IO_PINS_PARAMETERS-Struktur (gpioclx.h)

Artikel
03/01/2024

Die GPIO_DISCONNECT_IO_PINS_PARAMETERS-Struktur beschreibt eine Reihe von GPIO-Pins (General Purpose E/O), 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;

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, von dem die Verbindung getrennt werden soll. Wenn der GPIO-Controller über N-Pins verfügt, 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 .

DisconnectMode

Ob die GPIO-Pins in der verbindung, die geschlossen wird, werden als Eingaben oder als Ausgaben konfiguriert. Der Wert dieses Members 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 das PreserveConfiguration-Flagbit festgelegt ist, behält der GPIO-Controllertreiber die Konfiguration der Pins bei, nachdem sie getrennt wurden. Weitere Informationen finden Sie in den Hinweisen.

Hinweise

Der DisconnectParameters-Parameter auf 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 den Pin standardmäßig 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 zu überschreiben. Das Flag weist den GPIO-Controllertreiber an, die Konfiguration der E/A-Pins beizubehalten, die getrennt werden.

Beispielsweise kann ein Peripheriegerätetreiber eine logische Verbindung mit einem GPIO-E/A-Pin öffnen, der als Ausgabe konfiguriert ist, und dann den Bitwert 1 in den Pin schreiben. Mit dem PreserveConfiguration-Flag kann der Treiber die Verbindung schließen, ohne die Ausgabeebene des Pins zu ändern. Wenn der Treiber später den Ausgabepegel des Pins von 1 auf 0 ändern muss, öffnet der Treiber eine neue Verbindung mit dem Pin.