Fungsi StorPortAcquireMSISpinLock (storport.h)

Rutinitas StorPortAcquireMSISpinLock memperoleh kunci spin message signaled interrupt (MSI) yang terkait dengan pesan yang ditentukan.

Sintaksis

ULONG StorPortAcquireMSISpinLock(
  [in] PVOID  HwDeviceExtension,
       ULONG  MessageId,
  [in] PULONG OldIrql
);

Parameter

[in] HwDeviceExtension

Penunjuk ke ekstensi perangkat keras untuk adaptor bus host (HBA).

MessageId

Pengidentifikasi pesan yang kunci putarannya diperoleh penelepon.

[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:

Mengembalikan 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 NULL.

Komentar

Driver miniport memanggil rutinitas StorPortAcquireMSISpinLock untuk memperoleh kunci spin MSI untuk pesan tertentu. Untuk melepaskan kunci putaran, driver miniport memanggil rutinitasStorPortReleaseMSISpinLock. Rutinitas ini digunakan oleh driver miniport untuk memperoleh kunci putar MSI untuk pesan individual hanya ketika InterruptSynchronizationMode anggota struktur PORT_CONFIGURATION_INFORMATION diatur ke InterruptSynchronizePerMessage.

Ketika miniport perlu disinkronkan dengan semua pesan, miniport dapat menggunakan satu panggilan untuk StorPortAcquireSpinLock yang akan memperoleh kunci untuk setiap pesan dalam urutan yang tepat.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Rutinitas ini tersedia dimulai dengan Windows Vista.
Platform Target	Universal
Header	storport.h (termasuk Storport.h)
IRQL	Tingkat apa pun

Lihat juga

PORT_CONFIGURATION_INFORMATION

StorPortAcquireSpinLock

StorPortReleaseMSISpinLock