структура PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES (pep_x.h)
Структура PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES содержит список необработанных ресурсов, необходимых для управления питанием устройства.
Синтаксис
typedef struct _PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES {
[in] PEPHANDLE DeviceHandle;
[in] ULONG RequestFlags;
[out] NTSTATUS Status;
[in, out] SIZE_T BiosResourcesSize;
ACPI_METHOD_ARGUMENT BiosResources[ANYSIZE_ARRAY];
} PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES, *PPEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES;
Члены
[in] DeviceHandle
Значение PEPHANDLE, определяющее регистрацию устройства для служб ACPI. Подключаемый модуль расширения платформы (PEP) предоставил этот дескриптор в ответ на предыдущее уведомление PEP_NOTIFY_ACPI_REGISTER_DEVICE.
[in] RequestFlags
Набор флагов ввода. В настоящее время для этого элемента не определены флаги, которые всегда имеют значение PEP_ACPI_QDCR_FLAG_NONE (0x0).
[out] Status
Значение NTSTATUS, указывающее состояние этого запроса. Задайте этому участнику значение STATUS_SUCCESS, если PEP успешно предоставлял запрошенный список ресурсов. Задайте значение STATUS_BUFFER_TOO_SMALL, чтобы указать, что выходной буфер недостаточно велик, чтобы содержать список ресурсов.
[in, BiosResourcesSize
В входных данных размер буфера, выделенного для элемента BiosResources, в байтах. Этот размер буфера включает все связанные данные, которые могут следовать этому члену.
Если этот буфер недостаточно велик, чтобы содержать структуру ACPI_METHOD_ARGUMENT и связанные с ней данные, peP перезаписывает входное значение BiosResourcesSize с необходимым размером и задает элемент состояния значение STATUS_BUFFER_TOO_SMALL.
[in] BiosResources[ANYSIZE_ARRAY]
Выходной буфер, в который PEP записывает структуру ACPI_METHOD_ARGUMENT, содержащую запрошенный список ресурсов. Элемент Data этой структуры является первым элементом массива, который может продлиться до конца структуры. Размер буфера, указанный BiosResourcesSize, включает как структуру ACPI_METHOD_ARGUMENT, так и все элементы массива Data, которые соответствуют этой структуре.
Замечания
Эта структура используется уведомлением PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES. RequestFlags, BiosResourcesSizeи BiosResources элементы структуры содержат входные значения, предоставленные платформой управления питанием Windows (PoFx) при отправке этого уведомления. Если BiosResourcesSize входное значение слишком мало, peP должен перезаписать это значение. Элемент состояния содержит выходное значение, которое PEP записывает в эту структуру в ответ на уведомление.
Если входное значение, указанное в элементе BiosResourcesSize меньше требуемого размера, ТО PEP перезаписывает значение BiosResourcesSize с требуемым размером и задает элемент состояния STATUS_BUFFER_TOO_SMALL. В ответ PoFx попытается выделить буфер требуемого размера и отправить второе PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES уведомление в PEP для этого устройства.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Поддерживается начиная с Windows 10. |
| заголовка | pep_x.h (include Pep_x.h) |