Edit

PEP_ACPI_REGISTER_DEVICE structure (pep_x.h)

  • Article

The PEP_ACPI_REGISTER_DEVICE structure contains registration information about a device for which the platform extension plug-in (PEP) is to provide ACPI services.

Syntax

typedef struct _PEP_ACPI_REGISTER_DEVICE {
  [in]  PCUNICODE_STRING AcpiDeviceName;
  [in]  ULONG            InputFlags;
  [in]  POHANDLE         KernelHandle;
  [out] PEPHANDLE        DeviceHandle;
  [out] ULONG            OutputFlags;
} PEP_ACPI_REGISTER_DEVICE, *PPEP_ACPI_REGISTER_DEVICE;

Members

[in] AcpiDeviceName

An ANSI_STRING structure that contains the fully qualified BIOS name for the device. The same name was previously supplied as an input value in the PEP_ACPI_PREPARE_DEVICE notification for the device. This name specifies the path and name of the device in the ACPI namespace. For more information, see Enumerating Child Devices and Control Methods.

[in] InputFlags

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

[in] KernelHandle

A POHANDLE value that represents the registration of the device with the Windows power management framework (PoFx). The PEP can use this handle to identify the device in subsequent communications with PoFx.

[out] DeviceHandle

A PEPHANDLE value that identifies the registration of this device for ACPI services. This handle is created by the PEP. In subsequent ACPI service notifications, PoFx will use this handle to identify the device.

[out] OutputFlags

A set of output flags. No flags are currently defined for this member. Set this member to PEP_ACPI_REGISTER_DEVICE_OUTPUT_FLAG_NONE (0x0).

Remarks

This structure is used by the PEP_NOTIFY_ACPI_REGISTER_DEVICE notification. The AcpiDeviceName, InputFlags, and KernelHandle members of the structure contain input values that are supplied by PoFx when this notification is sent to the PEP. The DeviceHandle and OutputFlags members contains output values that the PEP writes to this structure in response to the notification.

Requirements

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

See also

ANSI_STRING

PEP_ACPI_PREPARE_DEVICE

PEP_DPM_REGISTER_DEVICE

PEP_NOTIFY_ACPI_REGISTER_DEVICE