共用方式為

StorPortAcquireMSISpinLock 函式 (storport.h)

  • 發行項

StorPortAcquireMSISpinLock 例程會取得訊號為中斷的訊息， (MSI) 與指定訊息相關聯的微調鎖定。

語法

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

參數

[in] HwDeviceExtension

主機總線適配卡的硬體裝置擴充功能指標， (HBA) 。

MessageId

訊息的標識碼，其微調鎖定呼叫端會取得。

[in] OldIrql

要用於 StorPortReleaseMSISpinLock 後續呼叫中原始 IRQL 值的記憶體指標。

傳回值

StorPortAcquireMSISpinLock 會傳回下列其中一個值：

傳回碼 Description
STOR_STATUS_NOT_IMPLEMENTED 此函式不會在作用中的操作系統上實作。
STOR_STATUS_SUCCESS 表示已成功取得微調鎖定。
STOR_STATUS_INVALID_PARAMETER HwDeviceExtension 為 NULL。

備註

迷你埠驅動程式會呼叫 StorPortAcquireMSISpinLock 例程，以取得特定訊息的 MSI 微調鎖定。 若要釋放微調鎖定，迷你埠驅動程式會呼叫 StorPortReleaseMSISpinLock 例程。 此例程是由迷你埠驅動程式用來取得個別訊息的 MSI 微調鎖定，只有在PORT_CONFIGURATION_INFORMATION結構的 InterruptSynchronizationMode 成員設定為 InterruptSynchronizePerMessage 時。

當迷你埠需要與所有訊息同步處理時，可以使用 對 StorPortAcquireSpinLock 的一個呼叫，以適當的順序取得每個訊息的鎖定。

規格需求

需求 值
最低支援的用戶端 此例程從 Windows Vista 開始可供使用。
目標平台 Universal
標頭 storport.h (包含 Storport.h)
IRQL 任何層級

另請參閱

PORT_CONFIGURATION_INFORMATION

StorPortAcquireSpinLock

StorPortReleaseMSISpinLock