ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX 構造体 (acpiioct.h)

  • [アーティクル]

ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX構造体は、IOCTL_ACPI_EVAL_METHOD_EX要求とIOCTL_ACPI_ASYNC_EVAL_METHOD_EX要求への入力として使用されます。 構造体は、ACPI 名前空間内のコントロール メソッドのパスと名前と、ULONG64型の入力引数を提供します。

構文

typedef struct _ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX {
  ULONG   Signature;
  CHAR    MethodName[256];
  ULONG64 IntegerArgument;
} ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX, ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX;

メンバー

Signature

拡張整数入力バッファーのシグネチャ。これは、ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_SIGNATURE_EXに設定する必要があります。

MethodName[256]

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

IntegerArgument

コントロール メソッドへの入力として渡されるULONG64型の引数値。

注釈

デバイスのドライバーは、IOCTL_ACPI_EVAL_METHOD_EX要求またはIOCTL_ACPI_ASYNC_EVAL_METHOD_EX要求を使用して、デバイスの子孫の子オブジェクトであるコントロール メソッドを評価できます。 メソッドが単一の整数入力引数を受け取る場合、これらの要求は次のように構造体ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX入力を受け取ります。

  • [署名] を [ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_SIGNATURE_EX] に設定します。
  • MethodName を NULL で終わる文字列に設定します。この文字列は、ACPI 名前空間のコントロール メソッドへの完全なパスと名前、または評価要求の送信先デバイスを基準とするメソッドのパスと名前を指定します。

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

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

  • IntegerArgument を入力整数値に設定します。
この構造体の使用方法の詳細については、「 ACPI コントロール メソッドの評価」を参照してください。

要件

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

こちらもご覧ください

IOCTL_ACPI_ASYNC_EVAL_METHOD_EX

IOCTL_ACPI_EVAL_METHOD_EX