struttura GPIO_DISCONNECT_IO_PINS_PARAMETERS (gpioclx.h)
La struttura GPIO_DISCONNECT_IO_PINS_PARAMETERS descrive un set di pin di I/O per utilizzo generico (GPIO) 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;
Membri
BankId
Identificatore della banca che contiene i pin GPIO. Se M è il numero di banche nel controller GPIO, BankId è un numero intero compreso tra 0 e M-1. L'estensione del framework GPIO (GpioClx) ottenuta 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 della matrice specifica il numero di un pin GPIO da cui disconnettersi. Se il controller GPIO ha n pin, 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 di PinNumberTable.
DisconnectMode
Indica se i pin GPIO nella connessione che viene chiusa vengono 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 oppure (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 la PreserveConfiguration flag bit è impostata, il driver del controller GPIO mantiene la configurazione dei pin dopo la disconnessione. Per altre informazioni, vedere Osservazioni.
Osservazioni
Il parametro DisconnectParameters alla routine di callback dell'evento CLIENT_DisconnectIoPins è un puntatore a una struttura GPIO_CONNECT_IO_PINS_PARAMETERS.
Per impostazione predefinita, quando un pin I/O GPIO è disconnesso, il driver del controller GPIO configura il pin in uno stato iniziale specifico della piattaforma. Il pin viene in genere configurato in uno stato a basso consumo 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 disconnessi.
Ad esempio, un driver di dispositivo periferico potrebbe aprire una connessione logica a un pin di I/O GPIO configurato come output e quindi scrivere un valore di bit pari a 1 nel pin. Il flag PreserveConfiguration consente al driver di chiudere la connessione senza modificare il livello di output del pin. Successivamente, se il driver deve modificare il livello di output del pin da 1 a 0, il driver apre una nuova connessione al pin.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Supportato a partire da Windows 8. |
| intestazione | gpioclx.h |
Vedere anche
CLIENT_CONTROLLER_BASIC_INFORMATION