ACPI_ENUM_CHILD構造体 (acpiioct.h)

ACPI_ENUM_CHILD構造体は ACPI_ENUM_CHILDREN_OUTPUT_BUFFER 構造体のメンバーであり、ACPI 名前空間内のオブジェクトの完全なパスと名前が含まれています。

構文

typedef struct _ACPI_ENUM_CHILD {
  ULONG Flags;
  ULONG NameLength;
  CHAR  Name[ANYSIZE_ARRAY];
} ACPI_ENUM_CHILD;

メンバーズ

Flags

列挙子オブジェクトに子オブジェクトがある場合に、ACPI ドライバーがACPI_OBJECT_HAS_CHILDRENするように設定するフラグ値。それ以外の場合、ACPI ドライバーはこの値を設定しません。

NameLength

Name 配列に含まれる ASCII 文字列内の NULL で終わる文字を含む文字数。

Name[ANYSIZE_ARRAY]

ACPI 名前空間内のオブジェクトのパスと名前を含む NULL で終わる ASCII 文字列。 パスと名前の形式の詳細については、このトピックで後述する「解説」セクションを参照してください。

備考

デバイスのドライバーは、IOCTL_ACPI_ENUM_CHILDREN 要求を使用して、デバイスの子オブジェクトを列挙します。 列挙子オブジェクトには、デバイスまたは指定された名前の任意のオブジェクトを指定できます。 この要求は、ACPI_ENUM_CHILDREN_OUTPUT_BUFFER構造体を返します。これには、ACPI_ENUM_CHILD構造体の配列を含む Children メンバーが含まれます。

Name メンバーに含まれるパスと名前は、ACPI 名前空間内のオブジェクトの完全修飾パスと名前の標準形式です。 たとえば、"ABCD" という名前のデバイスが ACPI 名前空間のルートの直下の子であり、そのデバイス 'ABCD' に 'CHLD' という名前の子デバイスがあり、その子デバイス 'CHLD' に '_FOO' という名前の直接の子オブジェクトがあるとします。 この場合、Name には '\ABCD が含まれます。CHLD._FOO.'

デバイスの子オブジェクトを列挙する方法については、「子デバイスの列挙と制御メソッドのを参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista 以降のバージョンの Windows。
ヘッダー	acpiioct.h (Acpiioct.h を含む)

関連項目

ACPI_ENUM_CHILDREN_OUTPUT_BUFFER

IOCTL_ACPI_ENUM_CHILDREN