ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1構造体 (acpiioct.h)

ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING構造体は、IOCTL_ACPI_EVAL_METHOD 要求と IOCTL_ACPI_ASYNC_EVAL_METHOD 要求への入力として使用されます。 構造体は、コントロール メソッドの名前と、ASCII 文字列である入力引数を提供します。

構文

typedef struct _ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1 {
  ULONG Signature;
  union {
    UCHAR MethodName[4];
    ULONG MethodNameAsUlong;
  } DUMMYUNIONNAME;
  ULONG StringLength;
  UCHAR String[ANYSIZE_ARRAY];
} ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1, ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING;

メンバーズ

Signature

ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATUREに設定する必要がある文字列入力バッファーのシグネチャ。

DUMMYUNIONNAME

DUMMYUNIONNAME.MethodName[4]

この共用体メンバーは、メソッドの名前を含む 4 要素の ASCII 文字配列です。 たとえば、'ABCD.' などです。

DUMMYUNIONNAME.MethodNameAsUlong

この共用体メンバーは、形式 (ULONG) ('DCBA') のメソッドの名前を含む ULONG 型の変数です。メソッド名は 4 要素の ASCII 文字配列 'ABCD' です。

StringLength

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

String[ANYSIZE_ARRAY]

StringLengthで指定された文字数を含む ASCII 文字列。 文字列に NULL ターミネータが含まれていません。

備考

ASCII 文字列を入力として受け取る ABCD という名前の制御メソッドがデバイスでサポートされている場合、デバイスのドライバーは、IOCTL_ACPI_EVAL_METHOD要求またはIOCTL_ACPI_ASYNC_EVAL_METHOD要求をデバイスに送信し、入力ACPI_EVAL_INPUT_BUFFER構造体のメンバーを次のように設定することで、メソッドを評価できます。

• [署名 をACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATUREに設定します。
• MethodName 'ABCD' に設定するか、MethodNameAsUlong を (ULONG)('DCBA') に します。
• StringLength 、文字列 によって指定される文字数設定します。
• 文字列 を入力文字列に設定します。

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

必要条件

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

関連項目

IOCTL_ACPI_ASYNC_EVAL_METHOD

IOCTL_ACPI_EVAL_METHOD