PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES Struktur (pepfx.h)
Die PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES-Struktur enthält eine Liste der Rohressourcen, die zum Steuern der Energie auf das Gerät benötigt werden.
Syntax
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;
Angehörige
[in] DeviceHandle
Ein PEPHANDLE-Wert, der die Registrierung des Geräts für ACPI-Dienste identifiziert. Das Plattformerweiterungs-Plug-In (PEP) hat dieses Handle als Reaktion auf eine vorherige PEP_NOTIFY_ACPI_REGISTER_DEVICE-Benachrichtigung bereitgestellt.
[in] RequestFlags
Eine Reihe von Eingabekennzeichnungen. Für dieses Element sind derzeit keine Kennzeichnungen definiert, die immer auf PEP_ACPI_QDCR_FLAG_NONE (0x0) festgelegt sind.
[out] Status
Ein NTSTATUS-Wert, der den Status dieser Abfrage angibt. Legen Sie dieses Mitglied auf STATUS_SUCCESS fest, wenn der PEP erfolgreich die angeforderte Liste der Ressourcen bereitstellt. Legen Sie auf STATUS_BUFFER_TOO_SMALL fest, um anzugeben, dass der Ausgabepuffer nicht groß genug ist, um die Ressourcenliste zu enthalten.
[in, BiosResourcesSize
Bei der Eingabe wird die Größe des Puffers in Bytes angegeben, der dem BiosResources Member zugeordnet ist. Diese Puffergröße enthält alle zugeordneten Daten, die diesem Element folgen können.
Wenn dieser Puffer nicht groß genug ist, um die ACPI_METHOD_ARGUMENT Struktur und die zugehörigen Daten zu enthalten, überschreibt der PEP den Eingabewert BiosResourcesS ize mit der erforderlichen Größe und legt den Status Member auf STATUS_BUFFER_TOO_SMALL fest.
[in] BiosResources[ANYSIZE_ARRAY]
Ein Ausgabepuffer, in den der PEP eine ACPI_METHOD_ARGUMENT Struktur schreibt, die die angeforderte Ressourcenliste enthält. Das Data Member dieser Struktur ist das erste Element in einem Array, das sich über das Ende der Struktur erstrecken kann. Die durch BiosResourcesSize- angegebene Puffergröße umfasst sowohl die ACPI_METHOD_ARGUMENT Struktur als auch alle Data Arrayelemente, die dieser Struktur folgen.
Bemerkungen
Diese Struktur wird von der PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES Benachrichtigung verwendet. Die RequestFlags, BiosResourcesSizeund BiosResources-Member der Struktur enthalten Eingabewerte, die vom Windows Power Management Framework (PoFx) bereitgestellt werden, wenn diese Benachrichtigung gesendet wird. Wenn der BiosResourcesSize Eingabewert zu klein ist, sollte der PEP diesen Wert überschreiben. Der Status Member enthält einen Ausgabewert, den der PEP als Reaktion auf die Benachrichtigung in diese Struktur schreibt.
Wenn der im BiosResourcesSize angegebene Eingabewert kleiner als die erforderliche Größe ist, überschreibt der PEP die BiosResourcesSize Eingabewert mit der erforderlichen Größe und legt den Status Member auf STATUS_BUFFER_TOO_SMALL fest. Als Reaktion versucht PoFx, einen Puffer der erforderlichen Größe zuzuweisen und eine zweite PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES Benachrichtigung an den PEP für dieses Gerät zu senden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Wird ab Windows 10 unterstützt. |
| Header- | pepfx.h (include Pep_x.h) |