функция UsbPm_Register (usbpmapi.h)

  • Статья

Регистрирует драйвер клиента в диспетчере политик, чтобы сообщить о поступлении и удалении концентратора и изменении состояния соединителя.

Синтаксис

NTSTATUS UsbPm_Register(
  [In]  PUSBPM_CLIENT_CONFIG ClientConfig,
  [Out] USBPM_CLIENT         *ClientHandle
);

Параметры

[In] ClientConfig

Указатель на структуру, предоставляемую вызывающим USBPM_CLIENT_CONFIG . Инициализируйте структуру, вызвав макрос USBPM_CLIENT_CONFIG_INIT.

[Out] ClientHandle

Указатель на расположение, которое получает дескриптор операции регистрации.

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

Возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае возвращает соответствующее значение NTSTATUS .

Комментарии

Функции обратного вызова драйвера клиента могут начать вызываться до возврата UsbPm_Register . Перед вызовом функций обратного вызова для параметра ClientHandle устанавливается допустимое значение.

Драйвер обычно вызывает UsbPm_Register в EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT драйвера и отменяет регистрацию в EVT_WDF_DEVICE_SELF_MANAGED_IO_CLEANUP , вызывая UsbPm_Deregister.

Требования

Требование Значение
Минимальная версия клиента Windows 10, версия 1809
Минимальная версия KMDF 1.27
Минимальная версия UMDF 2.27
Верхняя часть usbpmapi.h
Библиотека UsbPmApi.lib
IRQL PASSIVE_LEVEL