CM_Register_Notification 함수(cfgmgr32.h)

아티클
03/08/2023

CM_Register_Notification 함수는 지정된 형식의 PnP 이벤트가 발생할 때 호출할 애플리케이션 콜백 루틴을 등록합니다.

코드가 Windows 7 또는 이전 버전의 Windows를 대상으로 하는 경우 CM_Register_Notification 대신 RegisterDeviceNotification을 사용합니다. 커널 모드 호출자는 대신 IoRegisterPlugPlayNotification 을 사용해야 합니다.

구문

CMAPI CONFIGRET CM_Register_Notification(
  [in]           PCM_NOTIFY_FILTER   pFilter,
  [in, optional] PVOID               pContext,
  [in]           PCM_NOTIFY_CALLBACK pCallback,
  [out]          PHCMNOTIFICATION    pNotifyContext
);

매개 변수

[in] pFilter

CM_NOTIFY_FILTER 구조체에 대한 포인터입니다.

[in, optional] pContext

pCallback의 콜백 루틴에 전달할 컨텍스트를 포함하는 호출자 할당 버퍼에 대한 포인터입니다.

[in] pCallback

지정된 PnP 이벤트가 발생할 때 호출할 루틴에 대한 포인터입니다. 콜백 함수의 프로토타입은 설명 섹션을 참조하세요.

콜백 루틴의 Action 매개 변수는 CM_NOTIFY_ACTION 열거형의 값입니다.

알림을 받으면 콜백이 알림을 검사하는 방법은 콜백 루틴의 EventData 매개 변수의 FilterType 멤버에 따라 달라집니다.

CM_NOTIFY_FILTER_TYPE_DEVICEINTERFACE

콜백은 EventData-u.DeviceInterface>를 검사해야 합니다.

CM_NOTIFY_FILTER_TYPE_DEVICEHANDLE

콜백은 EventData-u.DeviceHandle>을 검사해야 합니다.

CM_NOTIFY_FILTER_TYPE_DEVICEINSTANCE

콜백은 EventData-u.DeviceInstance>를 검사해야 합니다.

[out] pNotifyContext

등록 호출에 해당하는 HCMNOTIFICATION 핸들을 수신하는 포인터입니다.

반환 값

작업이 성공하면 함수는 CR_SUCCESS 반환합니다. 그렇지 않으면 Cfgmgr32.h에 정의된 CR_ 접두사 오류 코드 중 하나를 반환합니다.

설명

플러그 앤 플레이 디바이스 이벤트를 최대한 빨리 처리해야 합니다. 이벤트 처리기가 실행을 차단할 수 있는 작업(예: I/O)을 수행하는 경우 다른 스레드를 시작하여 작업을 비동기적으로 수행하는 것이 가장 좋습니다.

CM_Register_Notification 함수는 기존 디바이스 인터페이스에 대한 알림을 제공하지 않습니다. 기존 인터페이스를 검색하려면 먼저 CM_Register_Notification 호출한 다음 , CM_Get_Device_Interface_List 호출합니다. 드라이버가 CM_Register_Notification 호출한 후 인터페이스를 사용하도록 설정했지만 드라이버가 CM_Get_Device_Interface_List 호출하기 전에 드라이버가 인터페이스 도착에 대한 알림을 수신하고 인터페이스도 CM_Get_Device_Interface_List 반환된 디바이스 인터페이스 인스턴스 목록에 표시됩니다.

CM_Register_Notification 반환된 HCMNOTIFICATION 핸들은 더 이상 필요하지 않은 경우 CM_Unregister_Notification 함수를 호출하여 닫아야 합니다.

콜백 루틴은 다음 함수 프로토타입을 사용합니다.

typedef __callback DWORD (CALLBACK *PCM_NOTIFY_CALLBACK)(
    _In_ HCMNOTIFICATION       hNotify,
    _In_opt_ PVOID             Context,
    _In_ CM_NOTIFY_ACTION      Action,
    _In_reads_bytes_(EventDataSize) PCM_NOTIFY_EVENT_DATA EventData,
    _In_ DWORD                 EventDataSize
    );

CM_NOTIFY_ACTION_DEVICEQUERYREMOVE 알림에 응답하는 경우 PCM_NOTIFY_CALLBACK 콜백은 ERROR_SUCCESS 또는 ERROR_CANCELLED 적절하게 반환해야 합니다. 그렇지 않으면 콜백이 ERROR_SUCCESS 반환해야 합니다. 콜백은 다른 값을 반환해서는 안 됩니다. 다른 작업에 대한 설명은 CM_NOTIFY_ACTION 설명서를 참조하세요. 또한 EventData 매개 변수에서 이 콜백이 수신하는 구조체에 대한 자세한 내용은 CM_NOTIFY_EVENT_DATA 참조하세요.

예제

예를 들어 디바이스 인터페이스 도착 및 디바이스 제거 알림 등록을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Microsoft Windows 8 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	cfgmgr32.h(Cfgmgr32.h 포함)
라이브러리	Cfgmgr32.lib; Windows 10 OneCoreUAP.lib
DLL	CfgMgr32.dll