Edit

PEP_WORK_ACPI_EVALUATE_CONTROL_METHOD_COMPLETE structure (pep_x.h)

  • Article

The PEP_WORK_ACPI_EVALUATE_CONTROL_METHOD_COMPLETE structure contains the results of an ACPI control method that was asynchronously evaluated by the platform extension plug-in (PEP).

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;

Members

DeviceHandle

A POHANDLE value that represents the registration of the device with the Windows power management framework (PoFx). The PEP previously received this handle from PoFx during the PEP_NOTIFY_ACPI_REGISTER_DEVICE notification in which the PEP elected to provide ACPI services for the device.

CompletionFlags

A set of completion flags. No flags are currently defined for this member, which is always set to PEP_ACPI_EVALUATE_CONTROL_METHOD_COMPLETE_FLAG_NONE (0x0).

MethodStatus

CompletionContext

A pointer to a completion context value. This is the same pointer that PoFx passed to the PEP in the PEP_NOTIFY_ACPI_EVALUATE_CONTROL_METHOD notification that initiated the asynchronous evaluation of the ACPI control method.

OutputArgumentSize

The size, in bytes, of the buffer pointed to by the OutputArguments member.

OutputArguments

A pointer to a buffer to which the PEP has written the result of evaluating the ACPI control method. This buffer starts with a ACPI_METHOD_ARGUMENT structure, which might be followed by additional output data. PoFx allocated this buffer and passed the buffer pointer to the PEP in the PEP_NOTIFY_ACPI_EVALUATE_CONTROL_METHOD notification that initiated the asynchronous evaluation of the ACPI control method.

Remarks

The ControlMethodComplete member of the PEP_WORK_INFORMATION structure is a PEP_WORK_ACPI_EVALUATE_CONTROL_METHOD_COMPLETE structure.

A PEP_WORK_INFORMATION structure is included in the input parameters to the CompleteWork routine. The PEP writes the control method results to the ControlMethodComplete member of this structure before calling the routine. Evaluation of the control method was initiated by a previous PEP_NOTIFY_ACPI_EVALUATE_CONTROL_METHOD notification.

Requirements

Requirement Value
Minimum supported client Supported starting with Windows 10.
Header pep_x.h (include Pep_x.h)

See also

ACPI_METHOD_ARGUMENT

PEP_NOTIFY_ACPI_EVALUATE_CONTROL_METHOD

PEP_NOTIFY_ACPI_REGISTER_DEVICE

PEP_WORK_INFORMATION