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