struktur ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1 (acpiioct.h)

  • Artikel

Struktur ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING digunakan sebagai input ke permintaan IOCTL_ACPI_EVAL_METHOD dan permintaan IOCTL_ACPI_ASYNC_EVAL_METHOD . Struktur memasok nama metode kontrol dan argumen input yang merupakan string ASCII.

Sintaks

typedef struct _ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1 {
  ULONG Signature;
  union {
    UCHAR MethodName[4];
    ULONG MethodNameAsUlong;
  } DUMMYUNIONNAME;
  ULONG StringLength;
  UCHAR String[ANYSIZE_ARRAY];
} ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1, ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING;

Anggota

Signature

Tanda tangan buffer input string, yang harus diatur ke ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE.

DUMMYUNIONNAME

DUMMYUNIONNAME.MethodName[4]

Anggota gabungan ini adalah array karakter ASCII empat elemen yang berisi nama metode . Misalnya, 'ABCD.'

DUMMYUNIONNAME.MethodNameAsUlong

Anggota gabungan ini adalah variabel berjenis ULONG yang berisi nama metode dalam format (ULONG) ('DCBA'), di mana nama metode adalah array karakter ASCII empat elemen 'ABCD.'

StringLength

Jumlah karakter ASCII dalam array karakter yang disediakan oleh String.

String[ANYSIZE_ARRAY]

String karakter ASCII yang berisi jumlah karakter yang ditentukan oleh StringLength. String tidak menyertakan terminator NULL.

Keterangan

Jika perangkat mendukung metode kontrol bernama ABCD yang mengambil string ASCII sebagai input, driver untuk perangkat dapat mengevaluasi metode dengan mengirim permintaan IOCTL_ACPI_EVAL_METHOD atau permintaan IOCTL_ACPI_ASYNC_EVAL_METHOD ke perangkat dan mengatur anggota struktur ACPI_EVAL_INPUT_BUFFER input sebagai berikut:

  • Atur Tanda Tangan ke ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE.
  • Atur MethodName ke 'ABCD' atau MethodNameAsUlong ke (ULONG)('DCBA').
  • Atur StringLength ke jumlah karakter yang disediakan oleh 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 2000 dan versi Windows yang lebih baru.
Header acpiioct.h (termasuk Acpiioct.h)

Lihat juga

IOCTL_ACPI_ASYNC_EVAL_METHOD

IOCTL_ACPI_EVAL_METHOD