Fungsi RegisterOpRegionHandler (oprghdlr.h)

  • Artikel

Rutinitas RegisterOpRegionHandler mendaftarkan handler wilayah operasi dengan driver ACPI.

Sintaks

NTSTATUS RegisterOpRegionHandler(
  [in]  PDEVICE_OBJECT          DeviceObject,
  [in]  ULONG                   AccessType,
  [in]  ULONG                   RegionSpace,
  [in]  PACPI_OP_REGION_HANDLER Handler,
  [in]  PVOID                   Context,
  [in]  ULONG                   Flags,
  [out] PVOID                   *OperationRegionObject
);

Parameter

[in] DeviceObject

Arahkan ke objek perangkat fisik (PDO) yang mewakili perangkat ACPI yang menentukan wilayah operasi.

[in] AccessType

Menentukan ACPI_OPREGION_ACCESS_AS_COOKED.

[in] RegionSpace

Menentukan salah satu jenis ruang wilayah berikut.

Pengidentifikasi ruang wilayah Deskripsi
ACPI_OPREGION_REGION_SPACE_MEMORY Memori sistem
ACPI_OPREGION_REGION_SPACE_IO Ruang I/O
ACPI_OPREGION_REGION_SPACE_PCI_CONFIG Konfigurasi PCI
ACPI_OPREGION_REGION_SPACE_EC Pengontrol tersemat
ACPI_OPREGION_REGION_SPACE_SMB Bus manajemen sistem
ACPI_OPREGION_REGION_SPACE_CMOS_CONFIG Konfigurasi CMOS
ACPI_OPREGION_REGION_SPACE_PCIBARTARGET Daftar alamat dasar PCI
Nilai yang ditentukan vendor dari 0x80 ke 0xFF Ditentukan vendor

[in] Handler

Arahkan ke penangan wilayah operasi ACPI_OP_REGION_HANDLER-ketik (disediakan oleh driver fungsi perangkat ACPI).

[in] Context

Arahkan ke konteks wilayah operasi khusus perangkat (disediakan oleh driver fungsi perangkat ACPI).

[in] Flags

Dicadangkan untuk penggunaan internal.

[out] OperationRegionObject

Penunjuk ke buffer yang dialokasikan pemanggil yang, pada output, berisi penunjuk ke objek wilayah operasi yang dibuat driver ACPI untuk wilayah operasi.

Nilai kembali

Mengembalikan salah satu nilai status berikut:

Menampilkan kode Deskripsi
STATUS_SUCCESS Handler wilayah operasi berhasil didaftarkan.
STATUS_ACPI_INVALID_DATA Informasi yang ditentukan tidak valid.
STATUS_INSUFFICIENT_RESOURCES Rutinitas tidak dapat mengalokasikan sumber daya sistem yang diperlukan.
STATUS_Xxx Terjadi kesalahan internal.

Keterangan

Konteks wilayah operasi yang ditentukan oleh Konteks khusus perangkat dan hanya digunakan oleh driver fungsi. Biasanya, konteksnya adalah ekstensi perangkat untuk objek perangkat fungsional (FDO). Driver ACPI meneruskan konteks ini kembali ke driver fungsi ketika memanggil handler wilayah operasi. Objek wilayah operasi hanya digunakan oleh driver fungsi untuk mengidentifikasi wilayah operasi secara unik ketika membatalkan pendaftaran handler wilayah operasi.

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

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header oprghdlr.h (termasuk Oprghdlr.h)
Pustaka Oprghdlr.lib
IRQL PASSIVE_LEVEL

Lihat juga

ACPI_OP_REGION_HANDLER

DeRegisterOpRegionHandler