StorPortAcquireMSISpinLock 函式 (storport.h)
StorPortAcquireMSISpinLock 例程會取得與指定訊息相關聯的訊息訊號中斷 (MSI) 微調鎖定。
語法
ULONG StorPortAcquireMSISpinLock(
[in] PVOID HwDeviceExtension,
ULONG MessageId,
[in] PULONG OldIrql
);
參數
[in] HwDeviceExtension
主機總線適配卡 (HBA) 的硬體裝置擴充功能指標。
MessageId
呼叫端取得其微調鎖定之訊息的標識碼。
[in] OldIrql
要用於後續呼叫 storPortReleaseMSISpinLock 之原始 IRQL 值的記憶體指標。
傳回值
StorPortAcquireMSISpinLock 會傳回下列其中一個值:
傳回碼 | 描述 |
---|---|
STOR_STATUS_NOT_IMPLEMENTED | 此函式不會在作用中的作系統上實作。 |
STOR_STATUS_SUCCESS | 表示已成功取得微調鎖定。 |
STOR_STATUS_INVALID_PARAMETER | HwDeviceExtensionNULL。 |
言論
迷你埠驅動程式會呼叫 StorPortAcquireMSISpinLock 例程,以取得特定訊息的 MSI 微調鎖定。 為了釋放微調鎖定,迷你埠驅動程式會呼叫 StorPortReleaseMSISpinLock 例程。 此例程是由迷你埠驅動程式用來取得個別訊息的 MSI 微調鎖定,只有當 PORT_CONFIGURATION_INFORMATION 結構的 InterruptSynchronizationMode 成員設定為 InterruptSynchronizePerMessage時, 才會取得個別訊息的 MSI 微調鎖定。
當迷你埠需要與所有訊息同步處理時,可以使用一個呼叫來 StorPortAcquireSpinLock,這會依適當的順序取得每個訊息的鎖定。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows Vista 開始,即可使用此例程。 |
目標平臺 | 普遍 |
標頭 | storport.h (包括 Storport.h) |
IRQL | 任何層級 |