PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES-Struktur (pep_x.h)

  • Artikel

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)

Weitere Informationen

ACPI_METHOD_ARGUMENT

PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES

PEP_NOTIFY_ACPI_REGISTER_DEVICE