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 값은 콜백 함수가 호출되기 전에 유효한 값으로 설정됩니다.

드라이버는 일반적으로 드라이버의 EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT UsbPm_Register 호출하고 UsbPm_Deregister호출하여EVT_WDF_DEVICE_SELF_MANAGED_IO_CLEANUP 등록을 취소합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 10, 버전 1809
최소 KMDF 버전 1.27
최소 UMDF 버전 2.27
머리글 usbpmapi.h
라이브러리 UsbPmApi.lib
IRQL PASSIVE_LEVEL