하드웨어 알림

Windows는 LED 및 진동 메커니즘과 같은 알림 구성 요소의 하드웨어 독립적 지원을 위한 인프라를 제공합니다. 이 지원은 특히 클라이언트 드라이버의 신속한 개발을 허용하는 하드웨어 알림 구성 요소에 대한 KMDF(Kernel-Mode Driver Framework) 클래스 확장의 도입을 통해 제공됩니다. KMDF 클래스 확장은 기본적으로 WDM(Windows 드라이버 모델)의 포트 드라이버와 유사하게 지정된 디바이스 클래스에 대해 정의된 기능 집합을 제공하는 KMDF 드라이버입니다. 이 섹션에서는 하드웨어 알림 클래스 확장의 아키텍처에 대한 개요를 제공합니다.

KMDF에 대한 자세한 내용은 WDF를 사용하여 드라이버 개발을 참조하세요.

하드웨어 알림을 지원하려면 다음이 필요합니다.

• hwnclx.h

열거형

HWN_CLX_EXPORT_INDEX 내보내기 테이블의 각 하드웨어 알림 내보내기의 위치를 정의합니다.

Functions

HWN_CLIENT_GET_STATE 하드웨어 알림 구성 요소 상태를 가져오기 위해 클라이언트 드라이버에 의해 구현됩니다. 사용자가 상태 정보를 요청할 때 호출됩니다.
HWN_CLIENT_INITIALIZE_DEVICE 클라이언트 드라이버에 의해 구현되고 EVT_WDF_DEVICE_PREPARE_HARDWARE 호출의 결과로 호출됩니다.
HWN_CLIENT_QUERY_DEVICE_INFORMATION 하드웨어 알림 구성 요소 특성을 검색하기 위해 클라이언트 드라이버에 의해 구현됩니다.
HWN_CLIENT_SET_STATE 하드웨어 알림 구성 요소 상태를 설정하기 위해 클라이언트 드라이버에 의해 구현됩니다. 사용자가 드라이버의 상태를 변경하려고 할 때 호출됩니다.
HWN_CLIENT_START_DEVICE 하드웨어 알림 구성 요소를 시작하기 위해 클라이언트 드라이버에 의해 구현됩니다. EVT_WDF_DEVICE_D0_ENTRY 호출의 결과로 호출됩니다.
HWN_CLIENT_STOP_DEVICE 클라이언트 드라이버에 의해 구현되어 하드웨어 알림 구성 요소를 시작합니다. EVT_WDF_DEVICE_D0_EXIT 호출의 결과로 호출됩니다.
HWN_CLIENT_UNINITIALIZE_DEVICE 클라이언트 드라이버에 의해 구현되고 EVT_WDF_DEVICE_RELEASE_HARDWARE 호출의 결과로 호출됩니다. 이 콜백 함수는 하드웨어 알림 구성 요소를 초기화하지 않습니다.
HwNProcessAddDevicePostDeviceCreate I/O 큐를 만듭니다. 클라이언트 드라이버의 EVT_WDF_DRIVER_DEVICE_ADD 콜백 함수가 호출되고 디바이스 개체가 생성된 후에 호출되어야 합니다.
HwNProcessAddDevicePreDeviceCreate 디바이스를 다른 상태로 전환하기 위해 WDF(Windows Driver Foundation)에 디바이스 준비/해제 및 진입/종료 콜백을 제공합니다.
HwNRegisterClient 하드웨어 알림 클라이언트 드라이버 및 해당 콜백 함수를 클래스 확장에 등록합니다.
HwNUnregisterClient 클래스 확장을 사용하여 하드웨어 알림 클라이언트 드라이버 및 해당 콜백 함수의 등록을 취소합니다. 클라이언트 드라이버가 언로드될 때 이 함수를 호출해야 합니다.

구조체

CLIENT_DEVICE_INFORMATION CLIENT_DEVICE_INFORMATION 구조는 하드웨어 알림 콜백 HWN_CLIENT_QUERY_DEVICE_INFORMATION 클라이언트 디바이스 드라이버가 제공하는 총 하드웨어 알림 수를 반환하는 데 사용됩니다.
HWN_CLIENT_REGISTRATION_PACKET 클라이언트 드라이버가 등록될 때 클래스 확장에 전달되는 하드웨어 알림 클라이언트 드라이버 등록 패킷입니다. 버전 정보 및 클라이언트 드라이버 콜백 함수를 포함합니다.