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

  • Статья

Структура PEP_REGISTER_DEVICE_V2 описывает устройство, стек драйверов которого только что зарегистрирован с помощью платформы управления питанием Windows (PoFx).

Синтаксис

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

Значение POHANDLE, представляющее регистрацию устройства с помощью PoFx. Подключаемый модуль расширения платформы (PEP) ранее получил этот дескриптор от PoFx во время уведомления PEP_DPM_REGISTER_DEVICE , которое сообщило PEP о том, что стек драйверов устройства зарегистрировал устройство с помощью PoFx.

[in] Register

Указатель на структуру PEP_DEVICE_REGISTER_V2 , которая описывает атрибуты управления питанием всех компонентов устройства. Дополнительные сведения см. в подразделе "Примечания".

[out] DeviceHandle

Значение PEPHANDLE, создаваемое PEP для идентификации этого устройства. PoFx будет использовать этот дескриптор для идентификации устройства в будущих уведомлениях об управлении питанием устройств (DPM).

[out] DeviceAccepted

Значение перечисления PEP_DEVICE_ACCEPTANCE_TYPE , указывающее, является ли PEP владельцем устройства. PEP, который претендует на владение, отвечает за обработку уведомлений DPM для устройства.

Комментарии

Эта структура используется уведомлением PEP_DPM_REGISTER_DEVICE . Первые три элемента этой структуры содержат входные значения, предоставляемые PoFx. Последние два элемента содержат выходные значения, которые PEP записывает в структуру в ответ на это уведомление.

Элемент Register содержит указатель на входной буфер, выделенный PoFx. PoFx записывает структуру PEP_DEVICE_REGISTER_V2 и связанные данные в эту структуру перед отправкой уведомления о PEP_DPM_REGISTER_DEVICE в PEP. Содержимое этого буфера остается действительным только до тех пор, пока PEP не завершит обработку уведомления и не вернет результат обратного вызова AcceptDeviceNotification .

Требования

Требование Значение
Минимальная версия клиента Поддерживается начиная с Windows 10.
Верхняя часть pep_x.h (включая Pep_x.h)

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

AcceptDeviceNotification

PEP_DEVICE_ACCEPTANCE_TYPE

PEP_DEVICE_REGISTER_V2

PEP_DPM_REGISTER_DEVICE

UNICODE_STRING