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

Lihat juga

PORT_CONFIGURATION_INFORMATION

StorPortAcquireSpinLock

StorPortReleaseMSISpinLock