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	任意のレベル

こちらもご覧ください

PORT_CONFIGURATION_INFORMATION

StorPortAcquireSpinLock

StorPortReleaseMSISpinLock