PEP_WORK_ACPI_EVALUATE_CONTROL_METHOD_COMPLETE-Struktur (pep_x.h)

Artikel
03/01/2024

Die PEP_WORK_ACPI_EVALUATE_CONTROL_METHOD_COMPLETE-Struktur enthält die Ergebnisse einer ACPI-Steuerungsmethode, die asynchron vom Plattformerweiterungs-Plug-In (PEP) 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 mit dem 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 der PEP ausgewählt hat, ACPI-Dienste für das Gerät bereitzustellen.

CompletionFlags

Eine Reihe von Vervollständigungsflags. Für dieses Element sind derzeit keine Flags definiert, die immer auf PEP_ACPI_EVALUATE_CONTROL_METHOD_COMPLETE_FLAG_NONE (0x0) festgelegt ist.

MethodStatus

CompletionContext

Ein Zeiger auf einen Vervollständigungskontextwert. Dies ist derselbe Zeiger, den PoFx an den PEP in der PEP_NOTIFY_ACPI_EVALUATE_CONTROL_METHOD Benachrichtigung übergeben hat, die die asynchrone Auswertung der ACPI-Steuerungsmethode initiiert hat.

OutputArgumentSize

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

OutputArguments

Ein Zeiger auf einen Puffer, in den der PEP das Ergebnis der Auswertung der ACPI-Steuerungsmethode geschrieben hat. Dieser Puffer beginnt mit einer ACPI_METHOD_ARGUMENT-Struktur , der möglicherweise zusätzliche Ausgabedaten folgen. PoFx hat diesen Puffer zugeordnet und den Pufferzeiger an den PEP in der PEP_NOTIFY_ACPI_EVALUATE_CONTROL_METHOD Benachrichtigung übergeben, die die asynchrone Auswertung der ACPI-Steuerungsmethode 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. Pep schreibt die Ergebnisse der Steuerelementmethode in das ControlMethodComplete-Element dieser Struktur, bevor die Routine aufgerufen wird. Die Auswertung der Kontrollmethode wurde durch eine vorherige PEP_NOTIFY_ACPI_EVALUATE_CONTROL_METHOD Benachrichtigung initiiert.