estrutura PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES (pep_x.h)

A estrutura PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES contém uma lista de recursos brutos necessários para controlar a energia do dispositivo.

Sintaxe

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;

Membros

[in] DeviceHandle

Um valor PEPHANDLE que identifica o registro do dispositivo para serviços ACPI. O PEP (plug-in de extensão de plataforma) forneceu esse identificador em resposta a uma notificação de PEP_NOTIFY_ACPI_REGISTER_DEVICE anterior.

[in] RequestFlags

Um conjunto de sinalizadores de entrada. Nenhum sinalizador está definido no momento para esse membro, que é sempre definido como PEP_ACPI_QDCR_FLAG_NONE (0x0).

[out] Status

Um valor NTSTATUS que indica o status dessa consulta. Defina esse membro como STATUS_SUCCESS se o PEP tiver êxito em fornecer a lista de recursos solicitada. Defina como STATUS_BUFFER_TOO_SMALL para indicar que o buffer de saída não é grande o suficiente para conter a lista de recursos.

[in, BiosResourcesSize

Na entrada, o tamanho, em bytes, do buffer alocado para o membro BiosResources . Esse tamanho de buffer inclui todos os dados associados que podem seguir esse membro.

Se esse buffer não for grande o suficiente para conter a estrutura ACPI_METHOD_ARGUMENT e seus dados associados, o PEP substituirá o valor de entrada de BiosResourcesSize pelo tamanho necessário e definirá o membro Status como STATUS_BUFFER_TOO_SMALL.

[in] BiosResources[ANYSIZE_ARRAY]

Um buffer de saída no qual o PEP grava uma estrutura ACPI_METHOD_ARGUMENT que contém a lista de recursos solicitada. O membro Data dessa estrutura é o primeiro membro em uma matriz que pode se estender além do final da estrutura. O tamanho do buffer especificado por BiosResourcesSize inclui a estrutura ACPI_METHOD_ARGUMENT e quaisquer elementos de matriz de dados que seguem essa estrutura.

Comentários

Essa estrutura é usada pela notificação PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES . Os membros RequestFlags, BiosResourcesSize e BiosResources da estrutura contêm valores de entrada fornecidos pela PoFx ( estrutura de gerenciamento de energia ) do Windows quando essa notificação é enviada. Se o valor de entrada BiosResourcesSize for muito pequeno, o PEP deverá substituir esse valor. O membro Status contém um valor de saída que o PEP grava nessa estrutura em resposta à notificação.

Se o valor de entrada especificado no membro BiosResourcesSize for menor que o tamanho necessário, o PEP substituirá o valor de entrada BiosResourcesSize pelo tamanho necessário e definirá o membro Status como STATUS_BUFFER_TOO_SMALL. Em resposta, a PoFx tentará alocar um buffer do tamanho necessário e enviar uma segunda notificação PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES ao PEP para este dispositivo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte a partir do Windows 10.
Cabeçalho	pep_x.h (inclua Pep_x.h)

Confira também

ACPI_METHOD_ARGUMENT

PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES

PEP_NOTIFY_ACPI_REGISTER_DEVICE