ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX構造体 (acpiioct.h)
ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX構造体は、IOCTL_ACPI_EVAL_METHOD_EX要求とIOCTL_ACPI_ASYNC_EVAL_METHOD_EX要求への入力として使用されます。 構造体は、ACPI 名前空間内のコントロール メソッドのパスと名前、およびACPI_METHOD_ARGUMENT構造体の入力引数配列 を 提供します。
構文
typedef struct _ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX {
ULONG Signature;
CHAR MethodName[256];
ULONG Size;
ULONG ArgumentCount;
ACPI_METHOD_ARGUMENT_V1 Argument[ANYSIZE_ARRAY];
} ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX, *PACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX, ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX, *PACPI_EVAL_INPUT_BUFFER_COMPLEX_EX;
メンバー
Signature
拡張複合入力バッファーのシグネチャ。これは、ACPI_EVAL_INPUT_BUFFER_COMPLEX_SIGNATURE_EXに設定する必要があります。
MethodName[256]
ACPI 名前空間内のコントロール メソッドのパスと名前を含む NULL で終わる ASCII 文字列。 NULL ターミネータを含め、文字列に含めることができる最大文字数は 256 文字です。
コントロール メソッドのパスと名前を指定する方法の詳細については、このトピックで後述する「解説」セクションを参照してください。
Size
Argument 配列に含まれるバイト数。
ArgumentCount
Argument 配列に含まれる可変長ACPI_METHOD_ARGUMENT構造体の数。 引数配列は、最大 7 つの引数構造体を保持できます。
Argument[ANYSIZE_ARRAY]
ACPI_METHOD_ARGUMENT構造体の配列。
注釈
デバイスのドライバーは、IOCTL_ACPI_EVAL_METHOD_EX要求またはIOCTL_ACPI_ASYNC_EVAL_METHOD_EX要求を使用して、デバイスの子孫の子オブジェクトである制御メソッドを評価できます。 メソッドが引数の複雑な配列を受け取る場合、これらの要求は次のように構造体ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX入力を受け取ります。
- [ 署名] を [ACPI_EVAL_INPUT_BUFFER_COMPLEX_SIGNATURE_EX] に設定します。
-
MethodName を NULL で終わる文字列に設定します。この文字列は、ACPI 名前空間のコントロール メソッドへの完全なパスと名前、または評価要求が送信されるデバイスに対するメソッドのパスと名前を指定します。
たとえば、ACPI 名前空間のルートの直接の子である "ABCD" という名前のデバイスに要求が送信され、"ABCD" デバイスが 'CHLD' という名前の子デバイスをサポートし、"CHLD" デバイスが '_FOO' という名前のメソッドをサポートしているとします。 この場合、評価要求で '\ABCD を指定できます。CHLD._FOO。ACPI 名前空間のコントロール メソッドの完全修飾パスと名前、または ACPI 名前空間の "ABCD" デバイスに対する相対パスとコントロール メソッドの名前である 'CHLD._FOO' です。
ACPI 名前空間でコントロール メソッドの完全修飾パスと名前を取得する方法の詳細については、「 子デバイスと制御メソッドの列挙」を参照してください。
- Size は Argument 配列のバイト数に設定されます。
- ArgumentCount は、 Argument 配列内の引数の数に設定されます。
- 引数 は、ACPI_METHOD_ARGUMENT構造体の配列に設定されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降のバージョンの Windows。 |
| Header | acpiioct.h (Acpiioct.h を含む) |