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