struktur ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX (acpiioct.h)

  • Artikel

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.
Untuk informasi selengkapnya tentang cara menggunakan struktur ini, lihat Mengevaluasi Metode Kontrol ACPI.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista dan versi Windows yang lebih baru.
Header acpiioct.h (termasuk Acpiioct.h)

Lihat juga

IOCTL_ACPI_ASYNC_EVAL_METHOD_EX

IOCTL_ACPI_EVAL_METHOD_EX