PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES-Struktur (pepfx.h)

Artikel
02/29/2024

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)

Weitere Informationen

ACPI_METHOD_ARGUMENT

PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES

PEP_NOTIFY_ACPI_REGISTER_DEVICE

Freigeben über