ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX結構 (acpiioct.h)
ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_EX 結構可用來作為 IOCTL_ACPI_EVAL_METHOD_EX 要求和 IOCTL_ACPI_ASYNC_EVAL_METHOD_EX 要求的輸入。 結構會在 ACPI 命名空間中提供控制項方法的路徑和名稱，以及 ASCII 字串的輸入自變數。
語法
typedef struct _ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX {
ULONG Signature;
CHAR MethodName[256];
ULONG StringLength;
UCHAR String[ANYSIZE_ARRAY];
} ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX, ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_EX;
成員
Signature
必須設定為ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE_EX之擴充字串輸入緩衝區的簽章。
MethodName[256]
NULL 終止的 ASCII 字串，其中包含 ACPI 命名空間中控件方法的路徑和名稱。 字串可包含的最大字元數，包括 NULL 終止符為 256。 如需如何提供控件方法路徑和名稱的詳細資訊，請參閱本主題稍後的一節。
StringLength
String 提供之字元陣列中的 ASCII 字元數。
String[ANYSIZE_ARRAY]
ASCII 字元陣列，其中包含 StringLength 所指定的字元數。 字元陣列不包含NULL終止符。
備註
裝置的驅動程式可以使用IOCTL_ACPI_EVAL_METHOD_EX要求或IOCTL_ACPI_ASYNC_EVAL_METHOD_EX要求來評估裝置子系子物件的控件方法。 如果方法採用單一字串輸入自變數，這些要求會採用輸入ACPI_EVAL_INPUT_BUFFER_STRING_EX結構，如下所示：
- 將 [簽章 ] 設定為 [ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE_EX]。
-
將 MethodName 設定為 NULL 終止的字串，該字串會提供 ACPI 命名空間中控制項方法的完整路徑和名稱，或是相對於評估要求傳送之裝置的方法路徑和名稱。
例如，假設要求傳送至名為 『ABCD』 的裝置，這是 ACPI 命名空間根目錄的立即子系、『ABCD』 裝置支援名為 『CHLD』 的子裝置，而 『CHLD』 裝置支援名為 『_FOO』 的方法。 在此情況下，評估要求可以提供 『\ABCD。CHLD._FOO，這是 ACPI 命名空間中控件方法的完整路徑和名稱，或 'CHLD._FOO'，這是相對於 ACPI 命名空間中 'ABCD' 裝置的控件方法路徑和名稱。
如需如何在 ACPI 命名空間中取得控制項方法的完整路徑和名稱的詳細資訊，請參閱 列舉子裝置和控制項方法。
- 將 StringLength 設定為 String 中的字元數。
- 將 String 設定為輸入字串。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista 和更新版本的 Windows。 |
| 標頭 | acpiioct.h (include Acpiioct.h) |