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 gpioClx (extensão de estrutura gpio) 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 bit do sinalizador PreserveConfiguration 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.
Comentários
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 de GPIO é desconectado, o driver do controlador GPIO configura o pino em um estado inicial específico da plataforma. Normalmente, o pino é 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 pino de E/S gpio configurado como uma saída e, em seguida, 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 |
|---|---|
| Cliente mínimo com suporte | Com suporte começando com Windows 8. |
| Cabeçalho | gpioclx.h |
Confira também
CLIENT_CONTROLLER_BASIC_INFORMATION