PEP_POWER_CONTROL_COMPLETE 구조체(pepfx.h)

PEP_POWER_CONTROL_COMPLETE 구조에는 PEP가 이전에 요청했고 디바이스 드라이버가 완료한 전원 제어 작업에 대한 상태 정보가 포함되어 있습니다.

구문

typedef struct _PEP_POWER_CONTROL_COMPLETE {
  [in] PEPHANDLE DeviceHandle;
  [in] LPCGUID   PowerControlCode;
  [in] PVOID     RequestContext;
  [in] SIZE_T    BytesReturned;
  [in] NTSTATUS  Status;
} PEP_POWER_CONTROL_COMPLETE, *PPEP_POWER_CONTROL_COMPLETE;

멤버

[in] DeviceHandle

디바이스를 식별하는 PEPHANDLE 값입니다. PEP는 이전 PEP_DPM_REGISTER_DEVICE 알림에 대한 응답으로 이 핸들을 제공했습니다.

[in] PowerControlCode

수행된 전원 제어 작업을 지정하는 GUID 값에 대한 포인터입니다. 이는 전원 제어 작업을 시작하기 위해 PEP_DPM_WORK 알림에 대한 응답으로 PEP가 제공한 값과 동일합니다.

[in] RequestContext

PEP가 원래 작업 요청에서 제공한 PEP_WORK_INFORMATION 구조에서 PEP에 의해 전송된 요청 컨텍스트에 대한 포인터입니다. 일반적으로 이 멤버는 PEP에서 요청한 전원 제어 작업의 결과를 포함하도록 출력 버퍼에 대한 포인터가 포함된 구조를 가리킵니다.

[in] BytesReturned

출력 버퍼에서 드라이버가 저장한 결과 데이터의 크기(바이트)입니다. 이 버퍼에 대한 자세한 내용은 RequestContext 멤버에 대한 설명을 참조하세요.

[in] Status

전원 제어 작업의 상태. 작업이 성공하면 PEP는 이 멤버를 STATUS_SUCCESS 설정합니다. 그렇지 않으면 PEP는 이 멤버를 적절한 오류 상태 코드로 설정합니다.

설명

이 구조는 PEP_DPM_POWER_CONTROL_COMPLETE 알림에 사용됩니다. 구조체의 5개 멤버 모두에서 제공하는 입력 값을 포함합니다.

출력 버퍼가 너무 작아서 작업에서 모든 결과 데이터를 수신할 수 없는 경우 PEP는 구조체의 Status 멤버를 STATUS_INSUFFICIENT_RESOURCES 설정하고 BytesReturned 멤버를 출력 버퍼의 필요한 크기로 설정하고(일반적으로) 출력 버퍼에 데이터를 쓰지 않습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 부터 지원합니다.
머리글	pepfx.h(Pep_x.h 포함)

추가 정보

GUID