Fungsi StorPortAsyncNotificationDetected (storport.h)

Artikel
06/15/2023

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	Makna
RAID_ASYNC_NOTIFY_FLAG_MEDIA_STATUS	Beri tahu Storport bahwa terjadi perubahan media.
RAID_ASYNC_NOTIFY_FLAG_DEVICE_STATUS	Beri tahu Storport bahwa status fungsi perangkat penyimpanan telah berubah.
RAID_ASYNC_NOTIFY_FLAG_DEVICE_OPERATION	Beri tahu Storport bahwa peran operasional perangkat penyimpanan telah berubah.

Nilai kembali

Nilai status yang menunjukkan hasil pemberitahuan. Ini bisa menjadi salah satu nilai ini:

Menampilkan kode	Deskripsi
STOR_STATUS_SUCCESS	Pemberitahuan perubahan status dijadwalkan untuk diproses.
STOR_STATUS_INVALID_PARAMETER	Tipe alamat tidak valid. -atau- HwDeviceExtension adalah NULL. -atau- Bendera berisi nilai yang tidak terdefinisi.
STOR_STATUS_INVALID_DEVICE_REQUEST	Unit perangkat penyimpanan tidak dapat ditemukan di alamat. -atau- Perangkat penyimpanan tidak mendukung pemberitahuan asinkron.
STOR_STATUS_BUSY	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