структура 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 предоставляется в ответ на уведомление 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.
Верхняя часть pepfx.h (включая Pep_x.h)

См. также раздел

GUID