DRIVER_STARTIO fungsi panggilan balik (wdm.h)

Artikel
02/27/2024

Rutinitas StartIo memulai operasi I/O yang dijelaskan oleh IRP.

Sintaks

DRIVER_STARTIO DriverStartio;

void DriverStartio(
  [in, out] _DEVICE_OBJECT *DeviceObject,
  [in, out] _IRP *Irp
)
{...}

Parameter

[in, out] 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 yang menjelaskan operasi I/O yang diminta.

Nilai kembali

Tidak ada

Keterangan

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

Rutinitas StartIo bersifat opsional. Rutinitas StartIo driver, jika disediakan, harus diberi nama XxxStartIo, di mana Xxx adalah awalan khusus driver. Rutinitas DriverEntry driver harus menyimpan alamat rutin StartIo di DriverObject-DriverStartIo>. (Jika tidak ada rutinitas yang disediakan, pointer ini harus NULL.)

Driver dapat menggunakan IoSetStartIoAttributes untuk mengatur atribut saat rutinitas StartIo-nya dipanggil.

Untuk informasi terperinci tentang menerapkan rutinitas StartIo driver, lihat Menulis StartIo Routine.

Contoh

Untuk menentukan rutinitas panggilan balik StartIo , 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 StartIo yang diberi nama MyStartIo, gunakan jenis DRIVER_STARTIO seperti yang ditunjukkan dalam contoh kode ini:

DRIVER_STARTIO MyStartIo;

Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:

_Use_decl_annotations_
VOID
  MyStartIo(
    struct _DEVICE_OBJECT  *DeviceObject,
    struct _IRP  *Irp 
    )
  {
      // Function body
  }

Jenis fungsi DRIVER_STARTIO 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_STARTIO 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.

Persyaratan

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

Bagikan melalui