estructura de PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES (pep_x.h)

  • Artículo

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)

Consulte también

ACPI_METHOD_ARGUMENT

PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES

PEP_NOTIFY_ACPI_REGISTER_DEVICE