ACPI_EVAL_INPUT_BUFFER_V1_EX 結構 (acpiioct.h)

ACPI_EVAL_INPUT_BUFFER_EX 結構會當做 IOCTL_ACPI_EVAL_METHOD_EX 要求的輸入,以及 IOCTL_ACPI_ASYNC_EVAL_METHOD_EX 要求。 結構會在不使用輸入引數的 ACPI 命名空間中提供控制項方法的路徑和名稱。

語法

typedef struct _ACPI_EVAL_INPUT_BUFFER_V1_EX {
  ULONG Signature;
  CHAR  MethodName[256];
} ACPI_EVAL_INPUT_BUFFER_V1_EX, *PACPI_EVAL_INPUT_BUFFER_V1_EX, ACPI_EVAL_INPUT_BUFFER_EX, *PACPI_EVAL_INPUT_BUFFER_EX;

成員

Signature

不包含引數的輸入緩衝區簽章,必須設定為ACPI_EVAL_INPUT_BUFFER_SIGNATURE_EX。

MethodName[256]

Null 終止的 ASCII 字串,其中包含 ACPI 命名空間中控制項方法的路徑和名稱。 字串可包含的最大字元數,包括 Null 結束字元為 256。 如需如何提供控制項方法路徑和名稱的詳細資訊,請參閱本主題稍後的一節。

備註

裝置的驅動程式可以使用IOCTL_ACPI_EVAL_METHOD_EX要求或IOCTL_ACPI_ASYNC_EVAL_METHOD_EX要求來評估屬於裝置子系子物件的控制項方法。 如果方法不接受輸入引數,這些要求會採用輸入ACPI_EVAL_INPUT_BUFFER_EX結構,如下所示:

  • [簽章 ] 設定為 [ACPI_EVAL_INPUT_BUFFER_SIGNATURE_EX]。
  • MethodName 設定為 Null 終止的字串,以提供 ACPI 命名空間中控制項方法的完整路徑和名稱,或是與評估要求傳送至其裝置相對的方法路徑和名稱。

    例如,假設要求會傳送至名為 'ABCD' 的裝置,這是 ACPI 命名空間根目錄的立即子系、'ABCD' 裝置支援名為 'CHLD' 的子裝置,而 'CHLD' 裝置支援名為 '_FOO' 的方法。 在此情況下,評估要求可以提供 '\ABCD。CHLD._FOO,這是 ACPI 命名空間中控制方法的完整路徑和名稱,或 'CHLD._FOO',這是 ACPI 命名空間中相對於 'ABCD' 裝置的控制方法路徑和名稱。

    如需如何在 ACPI 命名空間中取得控制項方法的完整路徑和名稱的詳細資訊,請參閱 列舉子裝置和控制項方法

如需如何使用這個結構的詳細資訊,請參閱 評估 ACPI 控制方法

必要條件

   
最低支援的用戶端 Windows Vista 和更新版本的 Windows。
標頭 acpiioct.h (包含 Acpiioct.h)

另請參閱

IOCTL_ACPI_ASYNC_EVAL_METHOD_EX

IOCTL_ACPI_EVAL_METHOD_EX