функция 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