PEP_REGISTER_DEVICE_V2 구조체(pep_x.h)

아티클
08/07/2023

PEP_REGISTER_DEVICE_V2 구조는 드라이버 스택이 PoFx(Windows 전원 관리 프레임워크)에 방금 등록된 디바이스를 설명합니다.

구문

typedef struct _PEP_REGISTER_DEVICE_V2 {
  [in]  PCUNICODE_STRING           DeviceId;
  [in]  POHANDLE                   KernelHandle;
  [in]  PPEP_DEVICE_REGISTER_V2    Register;
  [out] PEPHANDLE                  DeviceHandle;
  [out] PEP_DEVICE_ACCEPTANCE_TYPE DeviceAccepted;
} PEP_REGISTER_DEVICE_V2, *PPEP_REGISTER_DEVICE_V2;

멤버

[in] DeviceId

디바이스를 고유하게 식별하는 문자열입니다. 이 멤버는 디바이스 식별 문자열을 포함하는 UNICODE_STRING 구조체에 대한 포인터입니다.

[in] KernelHandle

PoFx를 사용하여 디바이스의 등록을 나타내는 POHANDLE 값입니다. PEP(플랫폼 확장 플러그 인)는 이전에 디바이스의 드라이버 스택이 PoFx에 디바이스를 등록했음을 PEP에 알리는 PEP_DPM_REGISTER_DEVICE 알림 중에 PoFx에서 이 핸들을 받았습니다.

[in] Register

디바이스에 있는 모든 구성 요소의 전원 관리 특성을 설명하는 PEP_DEVICE_REGISTER_V2 구조체에 대한 포인터입니다. 자세한 내용은 설명 부분을 참조하세요.

[out] DeviceHandle

PEP가 이 디바이스를 식별하기 위해 만드는 PEPHANDLE 값입니다. PoFx는 이 핸들을 사용하여 향후 DPM(디바이스 전원 관리) 알림에서 디바이스를 식별합니다.

[out] DeviceAccepted

PEP가 디바이스의 소유권을 클레임하는지 여부를 나타내는 PEP_DEVICE_ACCEPTANCE_TYPE 열거형 값입니다. 소유권을 주장하는 PEP는 디바이스에 대한 DPM 알림을 처리해야 합니다.

설명

이 구조체는 PEP_DPM_REGISTER_DEVICE 알림에서 사용됩니다. 이 구조체의 처음 세 멤버에는 PoFx에서 제공하는 입력 값이 포함됩니다. 마지막 두 멤버에는 PEP가 이 알림에 대한 응답으로 구조체에 쓰는 출력 값이 포함됩니다.

Register 멤버에는 PoFx에서 할당한 입력 버퍼에 대한 포인터가 포함되어 있습니다. PoFx는 PEP_DPM_REGISTER_DEVICE 알림을 PEP에 보내기 전에 이 구조체에 PEP_DEVICE_REGISTER_V2 구조 및 관련 데이터를 씁니다. 이 버퍼의 내용은 PEP가 알림 처리를 완료하고 AcceptDeviceNotification 콜백에서 반환될 때까지만 유효합니다.