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

структура 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 значение STATUS_BUFFER_TOO_SMALL.

[in] BiosResources[ANYSIZE_ARRAY]

Выходной буфер, в который PEP записывает ACPI_METHOD_ARGUMENT структуру, содержащую список запрошенных ресурсов. Элемент Data этой структуры является первым элементом в массиве, который может расширяться за пределы структуры. Размер буфера, указанный в BiosResourcesSize , включает как структуру ACPI_METHOD_ARGUMENT , так и все элементы массива данных , которые следуют за этой структурой.

Комментарии

Эта структура используется в уведомлении PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES . Элементы RequestFlags, BiosResourcesSize и BiosResources структуры содержат входные значения, предоставляемые платформой управления питанием Windows (PoFx) при отправке этого уведомления. Если входное значение BiosResourcesSize слишком мало, PEP должен перезаписать это значение. Элемент Status содержит выходное значение, которое PEP записывает в эту структуру в ответ на уведомление.

Если входное значение, указанное в элементе BiosResourcesSize , меньше требуемого размера, peP перезаписывает входное значение BiosResourcesSize требуемым размером и задает элементу Status значение STATUS_BUFFER_TOO_SMALL. В ответ PoFx попытается выделить буфер требуемого размера и отправить второе уведомление PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES в PEP для этого устройства.

Требования

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

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

ACPI_METHOD_ARGUMENT

PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES

PEP_NOTIFY_ACPI_REGISTER_DEVICE