DRIVER_CONTROL fungsi panggilan balik (wdm.h)

Rutinitas ini memulai transfer data DMA atau operasi transfer data.

Sintaks

DRIVER_CONTROL DriverControl;

IO_ALLOCATION_ACTION DriverControl(
  [in]      _DEVICE_OBJECT *DeviceObject,
  [in, out] _IRP *Irp,
  [in]      PVOID MapRegisterBase,
  [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, out] Irp

Penunjuk yang disediakan penelepon ke struktur IRP . Irp sama dengan nilai anggota CurrentIrpdeviceObject ketika rutinitas panggilan balik didaftarkan.

[in] MapRegisterBase

Dalam kasus AdapterControl, ini adalah nilai buram yang disediakan penelepon yang mewakili daftar peta yang telah ditetapkan sistem untuk operasi transfer ini. Driver meneruskan nilai ini ke FlushAdapterBuffers, FreeMapRegisters, dan MapTransfer.

Dalam kasus ControllerControl, ini tidak digunakan.

[in] Context

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

Nilai kembali

Rutinitas harus mengembalikan salah satu nilai yang ditentukan oleh enumerasi IO_ALLOCATION_ACTION . Driver perangkat master bus mengembalikan DeallocateObject atau DeallocateObjectKeepRegisters; driver yang menggunakan DMA sistem mengembalikan KeepObject.

Keterangan

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

Jika AdapterControl telah didaftarkan oleh rutinitas StartIo , maka parameter Irp dijamin menunjuk ke IRP yang saat ini sedang diproses oleh rutinitas StartIo . Jika tidak, driver harus mengatur anggota CurrentIrp dari struktur objek perangkat sebelum memanggil AllocateAdapterChannel.

Untuk informasi terperinci tentang menerapkan rutinitas AdapterControl , lihat Menulis Rutinitas AdapterControl.

Rutinitas ControllerControl driver dijalankan dalam konteks utas arbitrer di IRQL = DISPATCH_LEVEL.

Untuk mendaftarkan rutinitas ControllerControl untuk objek perangkat tertentu, driver harus memanggil IoCreateController untuk mendapatkan objek pengontrol, lalu memanggil IoAllocateController untuk meminta penggunaan pengontrol dan untuk menyediakan alamat rutin ControllerControl . Ketika pengontrol bebas, sistem memanggil rutinitas ControllerControl .

Untuk informasi terperinci tentang menerapkan rutinitas ControllerControl , lihat Menulis ControllerControl Routines. Lihat juga Objek Pengontrol.

Jenis fungsi DRIVER_CONTROL didefinisikan 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_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 Menganotasi Perilaku Fungsi.

Contoh

Untuk menentukan rutinitas panggilan balik, Anda harus terlebih dahulu memberikan deklarasi fungsi yang mengidentifikasi jenis rutinitas panggilan balik yang Anda tentukan. Windows menyediakan sekumpulan tipe fungsi panggilan balik untuk driver. 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 AdapterControl yang diberi nama MyAdapterControl, gunakan jenis DRIVER_CONTROL seperti yang ditunjukkan dalam contoh kode ini:

DRIVER_CONTROL MyAdapterControl;

Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:

_Use_decl_annotations_
IO_ALLOCATION_ACTION
 MyAdapterControl(
    struct _DEVICE_OBJECT  *DeviceObject,
    struct _IRP  *Irp,
    PVOID  MapRegisterBase,
    PVOID  Context
    )
  {
      // Function body
  }

Persyaratan

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

Lihat juga

AllocateAdapterChannel