PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES-Struktur (pep_x.h)
Die PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES-Struktur enthält eine Liste der Rohressourcen, die zum Steuern der Stromversorgung des Geräts erforderlich sind.
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
Ein Satz von Eingabeflags. Für diesen Member, der immer auf PEP_ACPI_QDCR_FLAG_NONE (0x0) festgelegt ist, sind derzeit keine Flags definiert.
[out] Status
Ein NTSTATUS-Wert, der die status dieser Abfrage angibt. Legen Sie diesen Member auf STATUS_SUCCESS fest, wenn pep die angeforderte Ressourcenliste 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 Byte. Diese Puffergröße enthält alle zugeordneten Daten, die diesem Member folgen können.
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 Status-Member 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. Der Data-Member dieser Struktur ist das erste Element in einem Array, das sich über das Ende der Struktur hinaus erstrecken kann. Die von BiosResourcesSize angegebene Puffergröße umfasst sowohl die ACPI_METHOD_ARGUMENT-Struktur als auch alle Data-Arrayelemente , 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 Status-Element 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 den Status-Member auf STATUS_BUFFER_TOO_SMALL fest. Als Reaktion darauf versucht PoFx, einen Puffer der erforderlichen Größe zuzuweisen, und sendet eine zweite PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES Benachrichtigung an die PEP für dieses Gerät.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt ab Windows 10. |
| Kopfzeile | pep_x.h (Pep_x.h einschließen) |