Fungsi StorPortAsyncNotificationDetected (storport.h)
Driver miniport penyimpanan memanggil StorPortAsyncNotificationDetected untuk memberi tahu driver Storport tentang peristiwa perubahan status perangkat penyimpanan.
Pemberitahuan diantrekan sebagai item kerja untuk pemrosesan yang ditangguhkan pada DISPATCH_LEVEL atau IRQL yang lebih rendah.
Sintaks
ULONG StorPortAsyncNotificationDetected(
[in] PVOID HwDeviceExtension,
PSTOR_ADDRESS Address,
ULONGLONG Flags
);
Parameter
[in] HwDeviceExtension
Penunjuk ke ekstensi perangkat keras. Ini adalah area penyimpanan per HBA yang dialokasikan dan diinisialisasi driver port atas nama driver miniport. Driver miniport biasanya menyimpan informasi khusus HBA dalam ekstensi ini, seperti status HBA dan rentang akses yang dipetakan untuk HBA. Area ini tersedia untuk driver miniport segera setelah driver miniport memanggil StorPortInitialize. Driver port membebaskan memori ini ketika melepas perangkat.
Address
Alamat perangkat penyimpanan dengan peristiwa perubahan status.
Flags
Pemberitahuan status untuk ditunjukkan ke Storport.
Parameter Bendera berisi kombinasi bitwise OR dari pemberitahuan status. Semua nilai status dapat diatur dengan nilai RAID_ASYNC_NOTIFY_SUPPORTED_FLAGS tunggal.
Nilai kembali
Nilai status yang menunjukkan hasil pemberitahuan. Ini bisa menjadi salah satu nilai ini:
Menampilkan kode | Deskripsi |
---|---|
|
Pemberitahuan perubahan status dijadwalkan untuk diproses. |
|
Tipe alamat tidak valid.
-atau- HwDeviceExtension adalah NULL. -atau- Bendera berisi nilai yang tidak terdefinisi. |
|
Unit perangkat penyimpanan tidak dapat ditemukan di alamat.
-atau- Perangkat penyimpanan tidak mendukung pemberitahuan asinkron. |
|
Pemberitahuan sebelumnya sedang dalam proses dan pemberitahuan ini tidak dapat dijadwalkan. |
Keterangan
Miniport dapat mendeteksi peristiwa status dalam rutinitas HwStorInterrupt-nya dan memanggil StorPortAsyncNotificationDetected untuk mengantre dan memproses pemberitahuan perubahan status nanti di IRQL yang lebih rendah.
Ketika diproses oleh Storport, pemberitahuan peristiwa status diteruskan ke driver kelas penyimpanan untuk memulai tindakan respons sistem yang diperlukan.
Jika parameter Bendera adalah 0, Storport akan menunjukkan semua nilai status dalam pemberitahuannya ke driver kelas penyimpanan.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 8 |
Target Platform | Universal |
Header | storport.h (termasuk Storport.h) |
IRQL | Apa pun |