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 des Geräts 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;
Member
[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 Eingabeflags. Für dieses Element sind derzeit keine Flags definiert, die immer auf PEP_ACPI_QDCR_FLAG_NONE (0x0) festgelegt sind.
[out] Status
Ein NTSTATUS-Wert, der die status dieser Abfrage angibt. Legen Sie diesen Member auf STATUS_SUCCESS fest, wenn pep die angeforderte Ressourcenliste erfolgreich bereitgestellt hat. 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 die Größe des Puffers, der dem BiosResources-Member zugeordnet ist, in Bytes. Diese Puffergröße enthält alle zugeordneten Daten, die diesem Member folgen könnten.
Wenn dieser Puffer nicht groß genug ist, um die ACPI_METHOD_ARGUMENT Struktur und die zugehörigen Daten zu enthalten, überschreibt PEP den Eingabewert von BiosResourcesSize mit der erforderlichen Größe und legt den Statusmember auf STATUS_BUFFER_TOO_SMALL fest.
[in] BiosResources[ANYSIZE_ARRAY]
Ein Ausgabepuffer, in den pep eine ACPI_METHOD_ARGUMENT Struktur schreibt, die die angeforderte Ressourcenliste enthält. Das Datenelement dieser Struktur ist das erste Element in einem Array, das sich über das Ende der Struktur erstrecken kann. Die von BiosResourcesSize angegebene Puffergröße umfasst sowohl die ACPI_METHOD_ARGUMENT-Struktur als auch alle Datenarrayelemente , die dieser Struktur folgen.
Hinweise
Diese Struktur wird von der PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES Benachrichtigung verwendet. Die Member RequestFlags, BiosResourcesSize und BiosResources 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. Das Statuselement enthält einen Ausgabewert, den pep als Reaktion auf die Benachrichtigung in diese Struktur schreibt.
Wenn der im BiosResourcesSize-Member angegebene Eingabewert kleiner als die erforderliche Größe ist, überschreibt PEP den Eingabewert BiosResourcesSize mit der erforderlichen Größe und legt das Statuselement 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 das PEP für dieses Gerät zu senden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Wird ab Windows 10 unterstützt. |
| Kopfzeile | pepfx.h (einschließlich Pep_x.h) |