struktur ACPI_EVAL_INPUT_BUFFER_V1_EX (acpiioct.h)

  • Artikel

Struktur ACPI_EVAL_INPUT_BUFFER_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 yang tidak mengambil argumen input.

Sintaks

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;

Anggota

Signature

Tanda tangan buffer input yang tidak menyertakan argumen, yang harus diatur ke ACPI_EVAL_INPUT_BUFFER_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.

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 tidak mengambil argumen input, permintaan ini mengambil struktur ACPI_EVAL_INPUT_BUFFER_EX input sebagai berikut:

  • Atur Tanda Tangan ke ACPI_EVAL_INPUT_BUFFER_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.

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