PEPCALLBACKNOTIFYDPM 콜백 함수(pep_x.h)

  • 아티클

AcceptDeviceNotification 이벤트 콜백 루틴은 Windows PoFx(전원 관리 프레임워크)의 DPM(디바이스 전원 관리) 알림을 처리합니다.

구문

PEPCALLBACKNOTIFYDPM Pepcallbacknotifydpm;

BOOLEAN Pepcallbacknotifydpm(
  [in]                ULONG Notification,
  [in, out, optional] PVOID Data
)
{...}

매개 변수

[in] Notification

DPM 알림 ID입니다. 이 매개 변수는 PoFx가 보내는 DPM 알림의 유형을 지정합니다. DPM 알림 ID 목록은 DPM(디바이스 전원 관리) 알림을 참조하세요.

[in, out, optional] Data

이 알림에 대한 입력 및/또는 출력 데이터를 포함하는 PoFx 할당 구조체에 대한 포인터입니다. 이 구조체의 유형은 알림에 지정된 알림 ID에 따라 달라집니다. 다양한 DPM 알림 ID에 대해 정의된 구조 유형 목록은 DPM(디바이스 전원 관리) 알림을 참조하세요.

반환 값

AcceptDeviceNotification 루틴은 알림을 처리하는 경우 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환해야 합니다.

설명

이 루틴은 디바이스에 대한 PEP(플랫폼 확장 플러그 인)에 의해 구현됩니다. PEP_INFORMATION 구조체의 AcceptDeviceNotification 멤버는 AcceptDeviceNotification 루틴에 대한 포인터입니다. PEP는 PoFxRegisterPlugin 또는 PoFxRegisterPluginEx 루틴을 호출하여 PEP의 AcceptDeviceNotification 루틴을 PoFx에 등록합니다.

PoFx는 이 루틴을 호출하여 PEP에 DPM 알림을 보냅니다. 이 호출에서 Notification 매개 변수는 알림 유형을 지정하고 Data 매개 변수는 이 알림과 연결된 형식의 데이터 구조를 가리킵니다. DPM 알림 ID 및 관련 구조 유형 목록은 DPM(디바이스 전원 관리) 알림을 참조하세요.

DPM 알림은 다양한 시스템, 디바이스 또는 구성 요소에 대해 PEP에 알리거나 디바이스 드라이버에서 PEP로 요청을 전달합니다.

AcceptDeviceNotification 루틴은 디바이스 드라이버의 모든 요청을 수락할 필요가 없습니다. 예를 들어 유휴 상주 힌트를 무시할 수 있습니다. 그러나 PEP는 PEP가 조치를 취하지 않도록 선택하더라도 대부분의 디바이스 전원 관리 알림을 이해하고 수락해야 합니다. PEP는 인식할 수 없는 모든 알림(FALSE 반환)을 거부해야 합니다.

AcceptDeviceNotification 루틴은 IRQL <= DISPATCH_LEVEL 호출할 수 있습니다. PEP의 AcceptAcpiNotification 루틴이 호출되는 IRQL은 전송되는 알림 유형에 따라 달라집니다. 알림 유형은 Notification 매개 변수로 지정됩니다. 자세한 내용은 DPM(디바이스 전원 관리) 알림 아래의 개별 참조 페이지를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10 부터 지원합니다.
대상 플랫폼 Windows
헤더 pep_x.h(Pep_x.h 포함)
IRQL <= DISPATCH_LEVEL

추가 정보

PEP_INFORMATION

PoFxRegisterPlugin

PoFxRegisterPluginEx