DRIVER_LIST_CONTROL fungsi panggilan balik (wdm.h)

Artikel
02/29/2024

Rutinitas AdapterListControl memulai operasi sebar/kumpulkan akses memori langsung (DMA).

Sintaks

DRIVER_LIST_CONTROL DriverListControl;

void DriverListControl(
  [in] _DEVICE_OBJECT *DeviceObject,
  [in] _IRP *Irp,
  [in] PSCATTER_GATHER_LIST ScatterGather,
  [in] PVOID Context
)
{...}

Parameter

[in] DeviceObject

Penunjuk yang disediakan penelepon ke struktur DEVICE_OBJECT . Ini adalah objek perangkat untuk perangkat target, yang sebelumnya dibuat oleh rutinitas AddDevice driver.

[in] Irp

Penunjuk yang disediakan penelepon ke struktur IRP yang menjelaskan operasi I/O, jika driver memiliki rutinitas StartIo . Jika tidak, tidak digunakan.

[in] ScatterGather

Penunjuk yang disediakan penelepon ke struktur SCATTER_GATHER_LIST yang menjelaskan wilayah sebar/kumpulkan.

[in] Context

Penunjuk yang disediakan penelepon ke informasi konteks yang ditentukan driver, ditentukan dalam panggilan sebelumnya ke AllocateAdapterChannel.

Nilai kembali

Tidak ada

Keterangan

Untuk mendaftarkan rutinitas AdapterListControl untuk objek perangkat tertentu, driver harus memanggil IoGetDmaAdapter untuk mendapatkan objek adaptor, lalu panggil GetScatterGatherList untuk meminta penggunaan adaptor dan untuk menyediakan alamat rutin AdapterListControl . Ketika adaptor gratis, sistem memanggil rutinitas AdapterListControl .

Contoh

Untuk menentukan rutinitas panggilan balik AdapterListControl , Anda harus terlebih dahulu memberikan deklarasi fungsi yang mengidentifikasi jenis rutinitas panggilan balik yang Anda tentukan. Windows menyediakan sekumpulan tipe fungsi panggilan balik untuk pengandar. Mendeklarasikan fungsi menggunakan jenis fungsi panggilan balik membantu Analisis Kode untuk Driver, Pemverifikasi Driver Statis (SDV), dan alat verifikasi lainnya menemukan kesalahan, dan itu adalah persyaratan untuk menulis driver untuk sistem operasi Windows.

Misalnya, untuk menentukan rutinitas panggilan balik AdapterListControl yang diberi nama MyAdapterListControl, gunakan jenis DRIVER_LIST_CONTROL seperti yang ditunjukkan dalam contoh kode ini:

DRIVER_LIST_CONTROL MyAdapterListControl;

Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:

_Use_decl_annotations_
VOID
  MyAdapterListControl(
    struct _DEVICE_OBJECT  *DeviceObject,
    struct _IRP  *Irp,
    PSCATTER_GATHER_LIST  ScatterGather,
    PVOID  Context
    )
  {
      // Function body
  }

Jenis fungsi DRIVER_LIST_CONTROL ditentukan dalam file header Wdm.h. Untuk mengidentifikasi kesalahan secara lebih akurat saat Anda menjalankan alat analisis kode, pastikan untuk menambahkan _Use_decl_annotations_ anotasi ke definisi fungsi Anda. Anotasi _Use_decl_annotations_ memastikan bahwa anotasi yang diterapkan ke jenis fungsi DRIVER_LIST_CONTROL dalam file header digunakan. Untuk informasi selengkapnya tentang persyaratan untuk deklarasi fungsi, lihat Mendeklarasikan Fungsi dengan Menggunakan Jenis Peran Fungsi untuk Driver WDM. Untuk informasi tentang _Use_decl_annotations_, lihat Perilaku Fungsi Anotasi.

Untuk informasi terperinci tentang menerapkan rutinitas AdapterListControl , lihat Menggunakan Scatter/Gather DMA.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
IRQL	Dipanggil pada DISPATCH_LEVEL.

Bagikan melalui