função GPIO_CLX_RegisterClient (gpioclx.h)

  • Artigo

O método GPIO_CLX_RegisterClient registra um driver de controlador gpio (E/S de uso geral) como um cliente da extensão de estrutura GPIO (GpioClx).

Sintaxe

NTSTATUS GPIO_CLX_RegisterClient(
  [in]      WDFDRIVER                        Driver,
  [in, out] PGPIO_CLIENT_REGISTRATION_PACKET RegistrationPacket,
  [in]      PUNICODE_STRING                  RegistryPath
);

Parâmetros

[in] Driver

Um identificador WDFDRIVER para o objeto de driver de estrutura para o driver do controlador GPIO.

[in, out] RegistrationPacket

Um ponteiro para uma estrutura de GPIO_CLIENT_REGISTRATION_PACKET alocada pelo chamador que contém as informações de registro do chamador. Essa estrutura contém ponteiros para as funções de retorno de chamada de evento implementadas pelo driver do controlador GPIO. Além disso, essa estrutura especifica o tamanho do contexto do dispositivo que o driver do controlador GPIO exige para seus dados de configuração internas e informações de estado.

[in] RegistryPath

Um ponteiro para uma estrutura UNICODE_STRING que contém o nome do caminho da chave do Registro para o driver do controlador GPIO. Esse parâmetro deve ser o nome do caminho do Registro que foi passado para a rotina driverEntry do driver. Para obter mais informações sobre chaves do registro de driver, consulte Árvores do Registro para Dispositivos e Drivers.

Retornar valor

GPIO_CLX_RegisterClient retornará STATUS_SUCCESS se a chamada for bem-sucedida. Os possíveis valores retornados incluem os seguintes códigos de erro.

Código de retorno Descrição
STATUS_INVALID_PARAMETER
 O parâmetro Driver, RegistrationPacket ou RegistryPath é NULL.
STATUS_GPIO_INVALID_REGISTRATION_PACKET
 O pacote de registro especificado não é válido.
STATUS_INSUFFICIENT_RESOURCES
 Sem memória.

Comentários

O driver do controlador GPIO chama esse método para registrar suas funções de retorno de chamada de evento com GpioClx. Normalmente, o driver chama esse método de sua rotina DriverEntry , que é executada logo após o driver ser carregado na memória.

Posteriormente, pouco antes do driver do controlador GPIO ser descarregado, o driver chama o método GPIO_CLX_UnregisterClient para cancelar seu registro com GpioClx.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 8.
Plataforma de Destino Universal
Cabeçalho gpioclx.h
Biblioteca Msgpioclxstub.lib
IRQL PASSIVE_LEVEL

Confira também

DriverEntry

GPIO_CLIENT_REGISTRATION_PACKET

GPIO_CLX_UnregisterClient

UNICODE_STRING