función GPIO_CLX_RegisterClient (gpioclx.h)

El método GPIO_CLX_RegisterClient registra un controlador de E/S de uso general (GPIO) como cliente de la extensión de marco GPIO (GpioClx).

Sintaxis

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

Parámetros

[in] Driver

Un controlador WDFDRIVER para el objeto de controlador de marco para el controlador GPIO.

[in, out] RegistrationPacket

Puntero a una estructura de GPIO_CLIENT_REGISTRATION_PACKET asignada por el autor de la llamada que contiene la información de registro del autor de la llamada. Esta estructura contiene punteros a las funciones de devolución de llamada de eventos que implementa el controlador del controlador GPIO. Además, esta estructura especifica el tamaño del contexto del dispositivo que requiere el controlador del controlador GPIO para sus datos de configuración internos e información de estado.

[in] RegistryPath

Puntero a una estructura de UNICODE_STRING que contiene el nombre de ruta de acceso de la clave del Registro para el controlador de controlador GPIO. Este parámetro debe ser el nombre de la ruta de acceso del Registro que se pasó a la rutina DriverEntry del controlador. Para obtener más información sobre las claves del Registro de controladores, consulte Árboles del Registro para dispositivos y controladores.

Valor devuelto

GPIO_CLX_RegisterClient devuelve STATUS_SUCCESS si la llamada se realiza correctamente. Entre los posibles valores devueltos se incluyen los siguientes códigos de error.

Código devuelto	Descripción
STATUS_INVALID_PARAMETER	El parámetro Driver, RegistrationPacket o RegistryPath es NULL.
STATUS_GPIO_INVALID_REGISTRATION_PACKET	El paquete de registro especificado no es válido.
STATUS_INSUFFICIENT_RESOURCES	Memoria insuficiente

Comentarios

El controlador del controlador GPIO llama a este método para registrar sus funciones de devolución de llamada de eventos con GpioClx. Normalmente, el controlador llama a este método desde su rutina DriverEntry , que se ejecuta poco después de cargar el controlador en la memoria.

Más adelante, justo antes de que se descargue el controlador del controlador GPIO, el controlador llama al método GPIO_CLX_UnregisterClient para cancelar su registro con GpioClx.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 8.
Plataforma de destino	Universal
Encabezado	gpioclx.h
Library	Msgpioclxstub.lib
IRQL	PASSIVE_LEVEL

Consulte también

DriverEntry

GPIO_CLIENT_REGISTRATION_PACKET

GPIO_CLX_UnregisterClient

UNICODE_STRING