estrutura PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES (pepfx.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. No momento, nenhum sinalizador é definido 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 de ACPI_METHOD_ARGUMENT e seus dados associados, o PEP substituirá o valor de entrada de BiosResourcesSize com o tamanho necessário e definirá o Status membro como STATUS_BUFFER_TOO_SMALL.
[in] BiosResources[ANYSIZE_ARRAY]
Um buffer de saída no qual o PEP grava uma estrutura de 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 Data que seguem essa estrutura.
Observações
Essa estrutura é usada pela notificação PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES. O RequestFlags, BiosResourcesSizee BiosResources membros da estrutura contêm valores de entrada fornecidos pela estrutura de gerenciamento de energia do Windows (PoFx) quando essa notificação é enviada. Se o BiosResourcesSize valor de entrada 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 biosResourcesSize valor de entrada com o 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 |
|---|---|
| de cliente com suporte mínimo | Com suporte a partir do Windows 10. |
| cabeçalho | pepfx.h (inclua Pep_x.h) |