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 されました。

備考

ミニポート ドライバーは、特定のメッセージの MSI スピン ロックを取得する StorPortAcquireMSISpinLock ルーチンを呼び出します。 スピン ロックを解放するには、ミニポート ドライバーは、StorPortReleaseMSISpinLock ルーチンを呼び出します。 このルーチンは、PORT_CONFIGURATION_INFORMATION 構造体の InterruptSynchronizationMode メンバーが InterruptSynchronizePerMessage 設定されている場合にのみ、個々のメッセージの MSI スピン ロックを取得するためにミニポート ドライバーによって使用されます。

ミニポートは、すべてのメッセージと同期する必要がある場合は、適切な順序で各メッセージのロックを取得する StorPortAcquireSpinLockをする 1 つの呼び出しを使用できます。

必要条件

要件	価値
サポートされる最小クライアント	このルーチンは、Windows Vista 以降で使用できます。
ターゲット プラットフォーム の	万国
ヘッダー	storport.h (Storport.h を含む)
IRQL	任意のレベル

関連項目

PORT_CONFIGURATION_INFORMATION

StorPortAcquireSpinLockの

StorPortReleaseMSISpinLockの