estructura de PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES (pep_x.h)
La estructura PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES contiene una lista de recursos sin procesar necesarios para controlar la alimentación en el dispositivo.
Sintaxis
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;
Miembros
[in] DeviceHandle
Valor PEPHANDLE que identifica el registro del dispositivo para los servicios ACPI. El complemento de extensión de plataforma (PEP) proporcionó este identificador en respuesta a una notificación de PEP_NOTIFY_ACPI_REGISTER_DEVICE anterior.
[in] RequestFlags
Un conjunto de marcas de entrada. Actualmente no hay marcas definidas para este miembro, que siempre se establece en PEP_ACPI_QDCR_FLAG_NONE (0x0).
[out] Status
Valor NTSTATUS que indica el estado de esta consulta. Establezca este miembro en STATUS_SUCCESS si el PEP ha proporcionado correctamente la lista de recursos solicitada. Establézcalo en STATUS_BUFFER_TOO_SMALL para indicar que el búfer de salida no es lo suficientemente grande como para contener la lista de recursos.
[in, BiosResourcesSize
En la entrada, el tamaño, en bytes, del búfer asignado para el miembro BiosResources . Este tamaño de búfer incluye los datos asociados que puedan seguir a este miembro.
Si este búfer no es lo suficientemente grande como para contener la estructura de ACPI_METHOD_ARGUMENT y sus datos asociados, el PEP sobrescribe el valor de entrada de BiosResourcesSize con el tamaño necesario y establece el miembro Status en STATUS_BUFFER_TOO_SMALL.
[in] BiosResources[ANYSIZE_ARRAY]
Un búfer de salida en el que el PEP escribe una estructura de ACPI_METHOD_ARGUMENT que contiene la lista de recursos solicitada. El miembro Data de esta estructura es el primer miembro de una matriz que podría extenderse más allá del final de la estructura. El tamaño del búfer especificado por BiosResourcesSize incluye tanto la estructura de ACPI_METHOD_ARGUMENT como los elementos de matriz de datos que siguen esta estructura.
Comentarios
La notificación de PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES usa esta estructura. Los miembros RequestFlags, BiosResourcesSize y BiosResources de la estructura contienen valores de entrada proporcionados por el marco de administración de energía de Windows (PoFx) cuando se envía esta notificación. Si el valor de entrada BiosResourcesSize es demasiado pequeño, el PEP debe sobrescribir este valor. El miembro Status contiene un valor de salida que el PEP escribe en esta estructura en respuesta a la notificación.
Si el valor de entrada especificado en el miembro BiosResourcesSize es menor que el tamaño necesario, el PEP sobrescribe el valor de entrada BiosResourcesSize con el tamaño necesario y establece el miembro Status en STATUS_BUFFER_TOO_SMALL. En respuesta, PoFx intentará asignar un búfer del tamaño necesario y enviará una segunda notificación PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES al PEP para este dispositivo.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Se admite a partir de Windows 10. |
| Encabezado | pep_x.h (incluya Pep_x.h) |