ACPI_OP_REGION_HANDLER fungsi panggilan balik (oprghdlr.h)

  • Artikel

Rutinitas jenis ACPI_OP_REGION_HANDLER disediakan oleh driver fungsi perangkat ACPI untuk menyediakan akses oleh driver ACPI ke wilayah operasi perangkat.

Sintaks

ACPI_OP_REGION_HANDLER AcpiOpRegionHandler;

NTSTATUS AcpiOpRegionHandler(
  ULONG AccessType,
  PVOID OperationRegionObject,
  ULONG Address,
  ULONG Size,
  PULONG Data,
  ULONG_PTR Context,
  PACPI_OP_REGION_CALLBACK CompletionHandler,
  PVOID CompletionContext
)
{...}

Parameter

AccessType

Menentukan salah satu jenis akses berikut:

Jenis akses Deskripsi
ACPI_OPREGION_WRITE Tulis ke buffer memori wilayah operasi.
ACPI_OPREGION_READ Baca dari buffer memori wilayah operasi.

OperationRegionObject

Menentukan objek wilayah operasi yang dikembalikan oleh RegisterOpRegionHandler untuk handler wilayah operasi.

Address

Menentukan offset byte di buffer memori wilayah operasi. Bergantung pada jenis akses, data ditransfer ke atau dari lokasi memori ini.

Size

Menentukan jumlah byte yang akan diakses.

Data

Penunjuk ke buffer data yang disediakan oleh driver ACPI yang terkait dengan akses. Untuk akses baca, byte ditransfer dari buffer memori wilayah operasi ke buffer data. Untuk akses tulis, byte ditransfer dari buffer data ke buffer memori wilayah operasi.

Context

Arahkan ke konteks wilayah operasi yang sama dengan yang ditentukan driver fungsi saat mendaftarkan handler wilayah operasi.

CompletionHandler

Dicadangkan untuk penggunaan internal.

CompletionContext

Dicadangkan untuk penggunaan internal.

Nilai kembali

Mengembalikan salah satu nilai status berikut:

Menampilkan kode Deskripsi
STATUS_SUCCESS Akses berhasil.
STATUS_INVALID_DEVICE_REQUEST Tipe akses tidak valid.
STATUS_Xxx Terjadi kesalahan internal.

Keterangan

Ketika driver ACPI memanggil handler wilayah operasi, driver menentukan nilai untuk Alamat dan Ukuran yang memastikan bahwa akses berada dalam wilayah operasi yang ditentukan dalam BIOS ACPI untuk perangkat ACPI. Driver fungsi perangkat ACPI harus memastikan bahwa buffer memori wilayah operasi yang dialokasikannya setidaknya sebesar, dalam byte, seperti wilayah operasi yang ditentukan untuk perangkat ACPI.

Untuk informasi selengkapnya tentang penangan wilayah operasi, lihat Mendukung Wilayah Operasi.

Rutinitas yang diketik ACPI_OP_REGION_HANDLER berjalan di IRQL penelepon.

Untuk informasi terperinci tentang batasan pada wilayah operasi, lihat Spesifikasi Konfigurasi Tingkat Lanjut dan Power Interface (ACPI).

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header oprghdlr.h (termasuk Oprghdlr.h)

Lihat juga

DeRegisterOpRegionHandler