структура PEP_POWER_CONTROL_COMPLETE (pep_x.h)

Статья
02/07/2025

Структура 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, предоставленное в ответ на уведомление PEP_DPM_WORK, чтобы инициировать операцию управления питанием.

[in] RequestContext

Указатель на контекст запроса, отправленный PEP в структуре PEP_WORK_INFORMATION, предоставленной PEP в исходном рабочем запросе. Как правило, этот элемент указывает на структуру, содержащую указатель на выходной буфер, содержащий результаты операции управления питанием, запрошенной PEP.

[in] BytesReturned

Размер в байтах результирующих данных, хранящихся драйвером в выходном буфере. Дополнительные сведения об этом буфере см. в описании элемента RequestContext.

[in] Status

Состояние операции управления питанием. Если операция выполнена успешно, peP задает этому элементу значение STATUS_SUCCESS. В противном случае PEP задает этому члену соответствующий код состояния ошибки.

Замечания

Эта структура используется уведомлением PEP_DPM_POWER_CONTROL_COMPLETE. Все пять элементов структуры содержат входные значения, предоставленные

Если буфер выходных данных слишком мал, чтобы получить все данные результатов из операции, PEP задает элемент status структуры на STATUS_INSUFFICIENT_RESOURCES, задает элемент BytesReturned требуемый размер выходного буфера, а (обычно) не записывает данные в выходной буфер.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается начиная с Windows 10.
заголовка	pep_x.h (include Pep_x.h)

См. также

GUID

Поделиться через