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 | HwDeviceExtension が NULL でした。 |
注釈
ミニポート ドライバーは 、StorPortAcquireMSISpinLock ルーチンを呼び出して、特定のメッセージの MSI スピン ロックを取得します。 スピン ロックを解放するために、ミニポート ドライバーは StorPortReleaseMSISpinLock ルーチンを呼び出します。 このルーチンは、ミニポート ドライバーが個々のメッセージの MSI スピン ロックを取得する場合にのみ、PORT_CONFIGURATION_INFORMATION構造体の InterruptSynchronizationMode メンバーが InterruptSynchronizePerMessage に設定されている場合に使用されます。
ミニポートは、すべてのメッセージと同期する必要がある場合は、適切な順序で各メッセージのロックを取得 する StorPortAcquireSpinLock への 1 回の呼び出しを使用できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | このルーチンは、Windows Vista 以降で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | storport.h (Storport.h を含む) |
| IRQL | 任意のレベル |