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 solicitada de recursos. 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 todos os elementos da matriz de dados que seguem essa estrutura.
Comentários
Essa estrutura é usada pela notificação de 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, o 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 começando com Windows 10. |
| Cabeçalho | pepfx.h (inclua Pep_x.h) |