HW_RESET_BUS fungsi panggilan balik (storport.h)

Artikel
02/29/2024

Rutinitas HwStorResetBus dipanggil oleh driver port untuk menghapus kondisi kesalahan.

Sintaks

HW_RESET_BUS HwResetBus;

BOOLEAN HwResetBus(
  PVOID DeviceExtension,
  ULONG PathId
)
{...}

Parameter

DeviceExtension

Penunjuk ke area penyimpanan driver miniport per HBA.

PathId

Mengidentifikasi bus SCSI yang akan direset.

Nilai kembali

Jika bus berhasil direset, HwStorResetBus mengembalikan TRUE.

Keterangan

Nama HwStorResetBus hanyalah tempat penampung. Prototipe aktual dari rutinitas ini didefinisikan dalam Storport.h sebagai berikut:

typedef
BOOLEAN
HW_RESET_BUS (
  _In_ PVOID  DeviceExtension,
  _In ULONG  PathId
  );

Driver port menjeda semua antrean IO perangkat untuk adaptor dan kemudian memanggil rutinitas HwStorResetBus di IRQL DISPATCH_LEVEL setelah memperoleh kunci putar StartIo. Driver miniport bertanggung jawab untuk menyelesaikan SRB yang diterima oleh HwStorStartIo untuk PathId selama rutinitas ini dan mengatur statusnya ke SRB_STATUS_BUS_RESET jika perlu.

Selain kunci putar StartIo yang diambil dan kemudian dirilis setelah HwStorResetBus kembali, jika miniport telah meminta dukungan beberapa saluran melalui PERF_CONFIGURATION_DATA, semua token saluran akan diambil dan, setelah kembalinya panggilan balik, dirilis. Ini memastikan bahwa tidak ada IO yang dikirim ke HwStorStartIo selama fase bus reset.

Contoh

Untuk menentukan fungsi panggilan balik HwStorResetBus , Anda harus terlebih dahulu memberikan deklarasi fungsi yang mengidentifikasi jenis fungsi 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 HwStorResetBus yang bernama MyHwResetBus, gunakan jenis HW_RESET_BUS seperti yang ditunjukkan dalam contoh kode ini:

HW_RESET_BUS MyHwResetBus;

Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:

_Use_decl_annotations_
BOOLEAN
MyHwResetBus (
  _In_ PVOID  DeviceExtension,
  _In_ ULONG  PahtId
  );
  {
      ...
  }

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

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	storport.h (termasuk Storport.h)
IRQL	DISPATCH_LEVEL (Lihat bagian Keterangan.)

Bagikan melalui