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。 |
Header | acpiioct.h (Acpiioct.h を含む) |