PEP_WORK_ACPI_EVALUATE_CONTROL_METHOD_COMPLETE-Struktur (pepfx.h)

Artikel
02/29/2024

Die PEP_WORK_ACPI_EVALUATE_CONTROL_METHOD_COMPLETE-Struktur enthält die Ergebnisse einer ACPI-Steuerungsmethode, die vom Plattformerweiterungs-Plug-In (PEP) asynchron ausgewertet wurde.

Syntax

typedef struct _PEP_WORK_ACPI_EVALUATE_CONTROL_METHOD_COMPLETE {
  POHANDLE              DeviceHandle;
  ULONG                 CompletionFlags;
  NTSTATUS              MethodStatus;
  PVOID                 CompletionContext;
  SIZE_T                OutputArgumentSize;
  PACPI_METHOD_ARGUMENT OutputArguments;
} PEP_WORK_ACPI_EVALUATE_CONTROL_METHOD_COMPLETE, *PPEP_WORK_ACPI_EVALUATE_CONTROL_METHOD_COMPLETE;

Member

DeviceHandle

Ein POHANDLE-Wert, der die Registrierung des Geräts beim Windows Power Management Framework (PoFx) darstellt. Das PEP hat dieses Handle zuvor von PoFx während der PEP_NOTIFY_ACPI_REGISTER_DEVICE Benachrichtigung erhalten, in der pep ausgewählt hat, ACPI-Dienste für das Gerät bereitzustellen.

CompletionFlags

Ein Satz von Vervollständigungsflags. Für diesen Member, der immer auf PEP_ACPI_EVALUATE_CONTROL_METHOD_COMPLETE_FLAG_NONE (0x0) festgelegt ist, sind derzeit keine Flags definiert.

MethodStatus

CompletionContext

Ein Zeiger auf einen Abschlusskontextwert. Dies ist derselbe Zeiger, den PoFx an pep in der PEP_NOTIFY_ACPI_EVALUATE_CONTROL_METHOD Benachrichtigung übergeben hat, die die asynchrone Auswertung der ACPI-Steuerelementmethode initiiert hat.

OutputArgumentSize

Die Größe des Puffers in Bytes, auf den der OutputArguments-Member verweist.

OutputArguments

Ein Zeiger auf einen Puffer, in den pep das Ergebnis der Auswertung der ACPI-Steuerungsmethode geschrieben hat. Dieser Puffer beginnt mit einer ACPI_METHOD_ARGUMENT-Struktur , auf die möglicherweise zusätzliche Ausgabedaten folgen. PoFx hat diesen Puffer zugeordnet und den Pufferzeiger an pep in der PEP_NOTIFY_ACPI_EVALUATE_CONTROL_METHOD Benachrichtigung übergeben, die die asynchrone Auswertung der ACPI-Steuerelementmethode initiiert hat.

Hinweise

Das ControlMethodComplete-Element der PEP_WORK_INFORMATION-Struktur ist eine PEP_WORK_ACPI_EVALUATE_CONTROL_METHOD_COMPLETE-Struktur .

Eine PEP_WORK_INFORMATION-Struktur ist in den Eingabeparametern für die CompleteWork-Routine enthalten. Der PEP schreibt die Ergebnisse der Steuerungsmethode in den ControlMethodComplete-Member dieser Struktur, bevor die Routine aufgerufen wird. Die Auswertung der Kontrollmethode wurde durch eine vorherige PEP_NOTIFY_ACPI_EVALUATE_CONTROL_METHOD Benachrichtigung initiiert.