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]

ACPI 名前空間内の制御メソッドのパスと名前を含む NULL で終わる ASCII 文字列。 NULL ターミネータを含め、文字列に含めることができる最大文字数は 256 文字です。 コントロール メソッドのパスと名前を指定する方法の詳細については、このトピックの「解説」セクションを参照してください。

StringLength

文字列 によって提供される文字の配列内の ASCII 文字数。

String[ANYSIZE_ARRAY]

StringLength で指定された文字数含む ASCII 文字配列。 文字配列に 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 、ACPI 名前空間内のコントロール メソッドへの完全なパスと名前、または評価要求の送信先デバイスを基準とするメソッドのパスと名前を提供する NULL で終わる文字列に設定します。

  たとえば、要求が、ACPI 名前空間のルートの直下の子である "ABCD" という名前のデバイスに送信され、"ABCD" デバイスが 'CHLD' という名前の子デバイスをサポートしていること、および 'CHLD' デバイスが '_FOO' という名前のメソッドをサポートしているとします。 この場合、評価要求はいずれかの '\ABCD を指定できます。CHLD._FOO。これは、ACPI 名前空間内のコントロール メソッドの完全修飾パスと名前、または ACPI 名前空間の 'ABCD' デバイスを基準とする制御メソッドのパスと名前である 'CHLD._FOO' です。

  ACPI 名前空間のコントロール メソッドの完全修飾パスと名前を取得する方法の詳細については、「子デバイスとコントロール メソッドの列挙を参照してください。

• StringLength を文字列 の文字数設定します。
• 文字列 を入力文字列に設定します。

この構造体の使用方法の詳細については、「ACPI 制御メソッドの評価を参照してください。

必要条件

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

関連項目

IOCTL_ACPI_ASYNC_EVAL_METHOD_EX

IOCTL_ACPI_EVAL_METHOD_EX