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]
NULL 終止的 ASCII 字串,其中包含 ACPI 命名空間中對象的路徑和名稱。 如需路徑和名稱格式的詳細資訊,請參閱本主題稍後的一節。
備註
裝置的驅動程式會使用 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) |