estrutura GPIO_DISCONNECT_IO_PINS_PARAMETERS (gpioclx.h)
A estrutura GPIO_DISCONNECT_IO_PINS_PARAMETERS descreve um conjunto de pinos de E/S de uso geral (GPIO) que devem ser desconectados.
Sintaxe
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;
Membros
BankId
O identificador do banco que contém os pinos gpio. Se M for o número de bancos no controlador GPIO, BankId será um inteiro no intervalo de 0 a M–1. A extensão da estrutura gpio (GpioClx) obteve anteriormente o número de bancos no controlador da função de retorno de chamada de evento CLIENT_QueryControllerBasicInformation. Para obter mais informações, consulte Comentários em CLIENT_CONTROLLER_BASIC_INFORMATION.
PinNumberTable
Um ponteiro para uma matriz de valores PIN_NUMBER. Cada elemento de matriz especifica o número de um pino GPIO do qual se desconectar. Se o controlador GPIO tiver N pinos, os pinos serão numerados de 0 a N–1. O número de elementos nessa matriz é especificado pelo membro PinCount.
PinCount
O número de elementos na matriz PinNumberTable.
DisconnectMode
Se os pinos gpio na conexão que está sendo fechada são configurados como entradas ou como saídas. O valor desse membro é ConnectModeInput para uma conexão somente leitura, ConnectModeOutput para uma conexão somente gravação ou (ConnectModeInput | ConnectModeOutput) para uma conexão de leitura/gravação. Para obter mais informações, consulte GPIO_CONNECT_IO_PINS_MODE.
DisconnectFlags
Um conjunto de sinalizadores que controlam como os pinos gpio devem ser configurados depois de fechados. Se o PreserveConfiguration bit de sinalizador estiver definido, o driver do controlador GPIO preservará a configuração dos pinos depois que eles forem desconectados. Para obter mais informações, consulte Comentários.
Observações
O parâmetro DisconnectParameters para a rotina de retorno de chamada de evento CLIENT_DisconnectIoPins é um ponteiro para uma estrutura de GPIO_CONNECT_IO_PINS_PARAMETERS.
Por padrão, quando um pino de E/S gpio é desconectado, o driver do controlador GPIO configura o pino em um estado inicial específico da plataforma. O pino normalmente é configurado em um estado de baixa potência para reduzir a carga na bateria. No entanto, o sinalizador PreserveConfiguration pode ser usado para substituir esse comportamento padrão. O sinalizador informa ao driver do controlador GPIO para preservar a configuração dos pinos de E/S que estão sendo desconectados.
Por exemplo, um driver de dispositivo periférico pode abrir uma conexão lógica com um pin de E/S gpio configurado como uma saída e gravar um valor de bit de 1 no pino. O sinalizador PreserveConfiguration permite que o driver feche a conexão sem alterar o nível de saída do pino. Posteriormente, se o driver precisar alterar o nível de saída do pino de 1 para 0, o driver abrirá uma nova conexão com o pino.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Com suporte a partir do Windows 8. |
| cabeçalho | gpioclx.h |
Consulte também
CLIENT_CONTROLLER_BASIC_INFORMATION