struktur ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX (acpiioct.h)

  • Artikel

Struktur ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX digunakan sebagai input ke permintaan IOCTL_ACPI_EVAL_METHOD_EX dan permintaan IOCTL_ACPI_ASYNC_EVAL_METHOD_EX . Struktur ini memasok jalur dan nama metode kontrol di namespace ACPI dan array argumen input struktur ACPI_METHOD_ARGUMENT .

Sintaks

typedef struct _ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX {
  ULONG                   Signature;
  CHAR                    MethodName[256];
  ULONG                   Size;
  ULONG                   ArgumentCount;
  ACPI_METHOD_ARGUMENT_V1 Argument[ANYSIZE_ARRAY];
} ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX, *PACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX, ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX, *PACPI_EVAL_INPUT_BUFFER_COMPLEX_EX;

Anggota

Signature

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

Size

Jumlah byte yang dimuat array Argumen .

ArgumentCount

Jumlah struktur ACPI_METHOD_ARGUMENT panjang variabel yang dimuat array Argumen . Array Argumen dapat menampung maksimal tujuh struktur argumen.

Argument[ANYSIZE_ARRAY]

Array struktur ACPI_METHOD_ARGUMENT.

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 array argumen yang kompleks, permintaan ini mengambil struktur ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX input sebagai berikut:

  • Atur Tanda Tangan ke ACPI_EVAL_INPUT_BUFFER_COMPLEX_SIGNATURE_EX.
  • Atur MethodName ke string yang dihentikan NULL yang menyediakan 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.

  • Ukuran diatur ke jumlah byte dalam array Argumen .
  • ArgumentCount diatur ke jumlah argumen dalam array Argumen .
  • Argumen diatur ke array struktur ACPI_METHOD_ARGUMENT.
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

ACPI_METHOD_ARGUMENT

IOCTL_ACPI_ASYNC_EVAL_METHOD_EX

IOCTL_ACPI_EVAL_METHOD_EX