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
引数 配列に含まれるバイト数。
ArgumentCount
引数 配列に含まれる可変長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 、ACPI 名前空間内のコントロール メソッドへの完全なパスと名前、または評価要求の送信先デバイスに対するメソッドのパスと名前を指定する NULL で終わる文字列に設定します。
たとえば、要求が、ACPI 名前空間のルートの直下の子である "ABCD" という名前のデバイスに送信され、"ABCD" デバイスが 'CHLD' という名前の子デバイスをサポートしていること、および 'CHLD' デバイスが '_FOO' という名前のメソッドをサポートしているとします。 この場合、評価要求はいずれかの '\ABCD を指定できます。CHLD._FOO。これは、ACPI 名前空間内のコントロール メソッドの完全修飾パスと名前、または ACPI 名前空間の 'ABCD' デバイスを基準とする制御メソッドのパスと名前である 'CHLD._FOO' です。
ACPI 名前空間のコントロール メソッドの完全修飾パスと名前を取得する方法の詳細については、「子デバイスとコントロール メソッドの列挙を参照してください。
- Size は、引数 配列内のバイト数に設定されます。
- ArgumentCount は、Argument 配列内の引数の数に設定されます。
- 引数 は、ACPI_METHOD_ARGUMENT構造体の配列に設定されます。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista 以降のバージョンの Windows。 |
| ヘッダー | acpiioct.h (Acpiioct.h を含む) |