GPIO_DISCONNECT_IO_PINS_PARAMETERS struttura (gpioclx.h)

  • Articolo

La struttura GPIO_DISCONNECT_IO_PINS_PARAMETERS descrive un set di pin di I/O (GPIO) generici che devono essere disconnessi.

Sintassi

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;

Members

BankId

Identificatore della banca contenente i pin GPIO. Se M è il numero di banche nel controller GPIO, BankId è un intero nell'intervallo da 0 a M-1. L'estensione del framework GPIO (GpioClx) ha ottenuto in precedenza il numero di banche nel controller dalla funzione di callback degli eventi CLIENT_QueryControllerBasicInformation . Per altre informazioni, vedere Osservazioni in CLIENT_CONTROLLER_BASIC_INFORMATION.

PinNumberTable

Puntatore a una matrice di valori PIN_NUMBER. Ogni elemento matrice specifica il numero di un pin GPIO da cui disconnettersi. Se il controller GPIO ha pin N, i pin sono numerati da 0 a N-1. Il numero di elementi in questa matrice viene specificato dal membro PinCount .

PinCount

Numero di elementi nella matrice PinNumberTable .

DisconnectMode

Indipendentemente dal fatto che i pin GPIO nella connessione chiusa siano configurati come input o come output. Il valore di questo membro è ConnectModeInput per una connessione di sola lettura, ConnectModeOutput per una connessione di sola scrittura o (ConnectModeInput | ConnectModeOutput) per una connessione di lettura/scrittura. Per altre informazioni, vedere GPIO_CONNECT_IO_PINS_MODE.

DisconnectFlags

Set di flag che controllano la modalità di configurazione dei pin GPIO dopo la chiusura. Se il bit del flag PreserveConfiguration è impostato, il driver del controller GPIO mantiene la configurazione dei pin dopo la disconnessione. Per altre informazioni, vedere la sezione Osservazioni.

Commenti

Il parametro DisconnectParameters della routine di callback eventi CLIENT_DisconnectIoPins è un puntatore a una struttura GPIO_CONNECT_IO_PINS_PARAMETERS .

Per impostazione predefinita, quando un pin I/O GPIO viene disconnesso, il driver del controller GPIO configura il pin in uno stato iniziale specifico della piattaforma. Il pin è in genere configurato in uno stato di bassa potenza per ridurre il carico sulla batteria. Tuttavia, il flag PreserveConfiguration può essere usato per eseguire l'override di questo comportamento predefinito. Il flag indica al driver del controller GPIO di mantenere la configurazione dei pin di I/O che vengono disconnessi.

Ad esempio, un driver di dispositivo periferico potrebbe aprire una connessione logica a un pin I/O GPIO configurato come output e quindi scrivere un valore bit pari a 1 al pin. Il flag PreserveConfiguration consente al driver di chiudere la connessione senza modificare il livello di output del pin. In seguito, se il driver deve modificare il livello di output del pin da 1 a 0, il driver apre una nuova connessione al pin.

Requisiti

Requisito Valore
Client minimo supportato Supportato a partire da Windows 8.
Intestazione gpioclx.h

Vedi anche

CLIENT_CONTROLLER_BASIC_INFORMATION

CLIENT_DisconnectIoPins

CLIENT_QueryControllerBasicInformation

GPIO_CONNECT_IO_PINS_MODE