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 | 任何層級 |