struktur ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX (acpiioct.h)
Struktur ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_EX digunakan sebagai input ke permintaan IOCTL_ACPI_EVAL_METHOD_EX dan ke permintaan IOCTL_ACPI_ASYNC_EVAL_METHOD_EX . Struktur memasok jalur dan nama metode kontrol di namespace ACPI dan argumen input yang merupakan string ASCII.
Sintaks
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;
Anggota
Signature
Tanda tangan buffer input string yang diperluas yang harus diatur ke ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE_EX.
MethodName[256]
String ASCII yang dihentikan NULL yang berisi jalur dan nama metode kontrol di namespace ACPI. Jumlah maksimum karakter yang dapat dimuat string, termasuk terminator NULL, adalah 256. Untuk informasi selengkapnya tentang cara menyediakan jalur dan nama metode kontrol, lihat bagian Keterangan nanti dalam topik ini.
StringLength
Jumlah karakter ASCII dalam array karakter yang disediakan oleh String.
String[ANYSIZE_ARRAY]
Array karakter ASCII yang berisi jumlah karakter yang ditentukan oleh StringLength. Array karakter tidak menyertakan terminator NULL.
Keterangan
Driver untuk perangkat dapat menggunakan permintaan IOCTL_ACPI_EVAL_METHOD_EX atau permintaan IOCTL_ACPI_ASYNC_EVAL_METHOD_EX untuk mengevaluasi metode kontrol yang merupakan objek turunan perangkat. Jika metode mengambil argumen input string tunggal, permintaan ini mengambil struktur ACPI_EVAL_INPUT_BUFFER_STRING_EX input sebagai berikut:
- Atur Tanda Tangan ke ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE_EX.
-
Atur MethodName ke string yang dihentikan NULL yang memasok jalur lengkap dan nama ke metode kontrol di namespace ACPI atau jalur dan nama metode yang relatif terhadap perangkat tempat permintaan evaluasi dikirim.
Misalnya, asumsikan bahwa permintaan dikirim ke perangkat bernama 'ABCD,' yang merupakan anak langsung dari akar namespace ACPI, bahwa perangkat 'ABCD' mendukung perangkat anak bernama 'CHLD,' dan bahwa perangkat 'CHLD' mendukung metode bernama '_FOO.' Dalam hal ini, permintaan evaluasi dapat menyediakan '\ABCD. CHLD._FOO,' yang merupakan jalur dan nama metode kontrol yang sepenuhnya memenuhi syarat di namespace ACPI, atau 'CHLD._FOO,' yang merupakan jalur dan nama metode kontrol yang relatif terhadap perangkat 'ABCD' di namespace ACPI.
Untuk informasi selengkapnya tentang cara mendapatkan jalur dan nama metode kontrol yang sepenuhnya memenuhi syarat di namespace ACPI, lihat Menghitung Perangkat Anak dan Metode Kontrol.
- Atur StringLength ke jumlah karakter dalam String.
- Atur String ke string input.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista dan versi Windows yang lebih baru. |
Header | acpiioct.h (termasuk Acpiioct.h) |