Fungsi StorPortAcquireMSISpinLock (storport.h)
Rutinitas StorPortAcquireMSISpinLock memperoleh kunci spin interupsi bersinyali pesan (MSI) yang terkait dengan pesan yang ditentukan.
Sintaks
ULONG StorPortAcquireMSISpinLock(
[in] PVOID HwDeviceExtension,
ULONG MessageId,
[in] PULONG OldIrql
);
Parameter
[in] HwDeviceExtension
Pointer ke ekstensi perangkat keras untuk adaptor bus host (HBA).
MessageId
Pengidentifikasi pesan yang kunci putarannya diperoleh pemanggil.
[in] OldIrql
Pointer ke penyimpanan untuk nilai IRQL asli yang akan digunakan dalam panggilan berikutnya ke StorPortReleaseMSISpinLock.
Mengembalikan nilai
StorPortAcquireMSISpinLock mengembalikan salah satu nilai berikut:
| Menampilkan kode | Deskripsi |
|---|---|
| STOR_STATUS_NOT_IMPLEMENTED | Fungsi ini tidak diimplementasikan pada sistem operasi aktif. |
| STOR_STATUS_SUCCESS | Menunjukkan bahwa kunci putar berhasil diperoleh. |
| STOR_STATUS_INVALID_PARAMETER | HwDeviceExtension adalah NULL. |
Keterangan
Driver miniport memanggil rutinitas StorPortAcquireMSISpinLock untuk memperoleh kunci putar MSI untuk pesan tertentu. Untuk melepaskan kunci putaran, driver miniport memanggil rutinitas StorPortReleaseMSISpinLock . Rutinitas ini digunakan oleh driver miniport untuk memperoleh kunci putar MSI untuk pesan individual hanya ketika anggota InterruptSynchronizationMode dari struktur PORT_CONFIGURATION_INFORMATION diatur ke InterruptSynchronizePerMessage.
Ketika miniport perlu disinkronkan dengan semua pesan, itu dapat menggunakan satu panggilan ke StorPortAcquireSpinLock yang akan memperoleh kunci untuk setiap pesan dalam urutan yang tepat.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Rutinitas ini tersedia dimulai dengan Windows Vista. |
| Target Platform | Universal |
| Header | storport.h (termasuk Storport.h) |
| IRQL | Tingkat apa pun |