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

String によって提供される文字の配列内の 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 に、String によって提供される文字数を設定します。
• [文字列] を入力文字列に設定します。

この構造体の使用方法の詳細については、「 ACPI コントロール メソッドの評価」を参照してください。

要件

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

こちらもご覧ください

IOCTL_ACPI_ASYNC_EVAL_METHOD

IOCTL_ACPI_EVAL_METHOD