struktur ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX (acpiioct.h)

  • Artikel

Struktur ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX digunakan sebagai input ke permintaan IOCTL_ACPI_EVAL_METHOD_EX dan permintaan IOCTL_ACPI_ASYNC_EVAL_METHOD_EX . Struktur memasok jalur dan nama metode kontrol di namespace ACPI dan argumen input jenis ULONG64.

Sintaks

typedef struct _ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX {
  ULONG   Signature;
  CHAR    MethodName[256];
  ULONG64 IntegerArgument;
} ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX, ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX;

Anggota

Signature

Tanda tangan buffer input bilangan buffer yang diperluas, yang harus diatur ke ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_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.

IntegerArgument

Nilai argumen jenis ULONG64 yang diteruskan sebagai input ke metode kontrol.

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 bilangan bulat tunggal, permintaan ini mengambil struktur ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX input sebagai berikut:

  • Atur Tanda Tangan ke ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_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 IntegerArgument ke nilai bilangan bulat 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