ACPI_ENUM_CHILDREN_INPUT_BUFFER structure (acpiioct.h)

The ACPI_ENUM_CHILDREN_INPUT_BUFFER structure is used as input to an IOCTL_ACPI_ENUM_CHILDREN request. The structure specifies which child objects to enumerate in the namespace of the device to which the request is sent.

Syntax

typedef struct _ACPI_ENUM_CHILDREN_INPUT_BUFFER {
  ULONG Signature;
  ULONG Flags;
  ULONG NameLength;
  CHAR  Name[ANYSIZE_ARRAY];
} ACPI_ENUM_CHILDREN_INPUT_BUFFER, *PACPI_ENUM_CHILDREN_INPUT_BUFFER;

Members

Signature

The signature of the input buffer, which must be set to ACPI_ENUM_CHILDREN_INPUT_BUFFER_SIGNATURE.

Flags

A flag that determines which objects the ACPI driver enumerates, as described in the Remarks section later in this topic.

NameLength

The number of ASCII characters, including a NULL-terminator, that the Name array contains.

Name[ANYSIZE_ARRAY]

A NULL-terminated, four-character ASCII string that contains the name of a child object that the ACPI driver uses to restrict the enumeration to child objects of the same name. For more information about how to supply an object name, see the Remarks section later in this topic.

Remarks

IOCTL_ACPI_ENUM_CHILDREN supports the following types of enumerations, depending on how the Flags member is set in the corresponding ACPI_ENUM_CHILDREN_INPUT_BUFFER structure:

For information about how to enumerate child objects of a device, see Enumerating Child Devices and Control Methods.

Requirements

Requirement	Value
Minimum supported client	Windows Vista and later versions of Windows.
Header	acpiioct.h (include Acpiioct.h)

See also

IOCTL_ACPI_ENUM_CHILDREN