структура 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.

Требования

См. также

AcceptDeviceNotification

PEP_DEVICE_ACCEPTANCE_TYPE

PEP_DEVICE_REGISTER_V2

PEP_DPM_REGISTER_DEVICE

UNICODE_STRING