функция GPIO_CLX_RegisterClient (gpioclx.h)

  • Статья

Метод GPIO_CLX_RegisterClient регистрирует драйвер контроллера GPIO в качестве клиента расширения платформы GPIO (GpioClx).

Синтаксис

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

Параметры

[in] Driver

Дескриптор WDFDRIVER для объекта драйвера платформы для драйвера контроллера GPIO.

[in, out] RegistrationPacket

Указатель на структуру GPIO_CLIENT_REGISTRATION_PACKET , которая содержит сведения о регистрации вызывающего абонента. Эта структура содержит указатели на функции обратного вызова событий, которые реализует драйвер контроллера GPIO. Кроме того, эта структура определяет размер контекста устройства, который требуется драйверу контроллера GPIO для внутренних данных конфигурации и сведений о состоянии.

[in] RegistryPath

Указатель на структуру UNICODE_STRING , содержащую имя пути к разделу реестра для драйвера контроллера GPIO. Этот параметр должен быть именем пути реестра, который был передан в подпрограмму DriverEntry драйвера. Дополнительные сведения о разделах реестра драйверов см. в разделе Деревья реестра для устройств и драйверов.

Возвращаемое значение

GPIO_CLX_RegisterClient возвращает STATUS_SUCCESS, если вызов выполнен успешно. Возможные возвращаемые значения включают следующие коды ошибок.

Код возврата Описание
STATUS_INVALID_PARAMETER
 Параметр Driver, RegistrationPacket или RegistryPath имеет значение NULL.
STATUS_GPIO_INVALID_REGISTRATION_PACKET
 Указанный пакет регистрации недопустим.
STATUS_INSUFFICIENT_RESOURCES
 Недостаточно памяти.

Комментарии

Драйвер контроллера GPIO вызывает этот метод для регистрации функций обратного вызова событий в GpioClx. Как правило, драйвер вызывает этот метод из своей подпрограммы DriverEntry , которая выполняется вскоре после загрузки драйвера в память.

Позже, непосредственно перед выгрузкой драйвера контроллера GPIO, драйвер вызывает метод GPIO_CLX_UnregisterClient , чтобы отменить регистрацию с помощью GpioClx.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 8.
Целевая платформа Универсальное
Верхняя часть gpioclx.h
Библиотека Msgpioclxstub.lib
IRQL PASSIVE_LEVEL

См. также раздел

DriverEntry

GPIO_CLIENT_REGISTRATION_PACKET

GPIO_CLX_UnregisterClient

UNICODE_STRING