StorPortAcquireSpinLock 関数 (storport.h)
StorPortAcquireSpinLock ルーチンは、指定されたスピン ロックを取得します。
構文
void StorPortAcquireSpinLock(
[in] PVOID DeviceExtension,
[in] STOR_SPINLOCK SpinLock,
[in] PVOID LockContext,
[in/out] PSTOR_LOCK_HANDLE LockHandle
);
パラメーター
[in] DeviceExtension
ミニポート ドライバーアダプターごとのデバイス拡張機能へのポインター。
[in] SpinLock
取得するスピン ロックを指定 するSTOR_SPINLOCK 型の列挙子値を指定します。 この関数の SpinLock は、 DpcLock、 StartIoLock、または InterruptLock のいずれかである必要があります。 StorportAcquireSpinLockEx を呼び出して、他の種類のスピン ロックを取得します。
[in] LockContext
SpinLock が DpcLock に設定されている場合にロックが保持される DPC オブジェクトへのポインター。 SpinLock が InterruptLock または StartIoLock のいずれかの型を示す場合、このメンバーは NULL である必要があります。
[in/out] LockHandle
返されたバッファーへのポインターには、ロック ハンドルが含まれます。 ロックを解除するには、呼び出し元がこのハンドルを StorPortReleaseSpinLock ルーチンに渡す必要があります。
戻り値
なし
解説
ミニポート ドライバーは、既に保持されているロックを取得したり、正しくない順序でロックを取得したりしないようにする必要があります。 これらの間違いのいずれかによって、システムのデッドロックが発生します。
特定のロックは、ミニポート ドライバーコールバック ルーチンを呼び出す前に、ポート ドライバーによって自動的に保持されます。 ミニポート ドライバーコールバック ルーチンごとに、次の表は、コールバック ルーチンを呼び出す前に、ポート ドライバーが自動的に取得するロックを示します。
| ミニポート ドライバー ルーチン | ポート ドライバーによって保持されるスピン ロック |
|---|---|
| HwStorFindAdapter | なし |
| HwStorInitialize | 割り込み (物理ミニポート)、なし (仮想ミニポート) |
| HwStorInterrupt | 割り込み |
| HwMSIInterruptRoutine | 割り込み |
| HwStorStartIo | StartIo (要求された同時実行チャネル <= 1 の場合にのみ物理ミニポート) |
| HwStorBuildIo | なし |
| HwStorTimer | Startio、割り込み (PORT_CONFIGURATION_INFORMATION の SynchronizationModel メンバーが StorSynchronizeHalfDuplex に設定されている場合) |
| HwStorResetBus | Startio、割り込み (PORT_CONFIGURATION_INFORMATION の SynchronizationModel メンバーが StorSynchronizeHalfDuplex に設定されている場合) |
| HwStorAdapterControl | [なし] : (Windows Server 2003 では、コントロールの種類が ScsiStopAdapter の場合、StartIo スピン ロックが保持されていました)。 |
| HwStorUnitControl | なし |
| HwStorTracingEnabled | なし |
| HwStorPassiveInitializeRoutine | なし |
| HwStorDpcRoutine | なし |
| HwStorStateChange | Startio、割り込み (PORT_CONFIGURATION_INFORMATION の SynchronizationModel メンバーが StorSynchronizeHalfDuplex に設定されている場合) |
スピン ロックは次の順序で取得する必要があるため、ポート ドライバーによって保持されるロックは、コールバック ルーチンをロックするロックの取得が許可されます。
- DPC または StartIo
- 割り込み
たとえば、ポート ドライバーがコールバック ルーチンを呼び出す前に割り込みスピン ロックを取得した場合、DPC スピン ロックと StartIo スピン ロックは割り込みスピン ロックよりも低い順序であるため、そのコールバック ルーチンは DPC または StartIo スピン ロックを取得できなくなります。 一方、ポート ドライバーがコールバック ルーチンを呼び出す前に StartIo スピン ロックを取得した場合、そのコールバック ルーチンは、実行時に 割り込み または DPC スピン ロックを取得できます。
次の表は、各ミニポート ドライバー ルーチンが取得できるスピン ロックを示しています。 ミニポート ドライバー ルーチンが StartIo スピン ロックと 割り込み スピン ロックの両方を取得する必要がある場合、ルーチンは常に最初に StartIo スピン ロックを取得する必要があります。
| ミニポート ドライバー ルーチン | 許可されたスピン ロック |
|---|---|
| HwStorFindAdapter | なし |
| HwStorInitialize | なし |
| HwStorInterrupt | なし |
| HwMSIInterruptRoutine | なし |
| HwStorStartIo | DPC、割り込み。 StartIo は、仮想ミニポート ドライバーまたは複数の同時実行チャネルを使用する物理ミニポート ドライバーから取得できることに注意してください。 |
| HwStorBuildIo | DPC、StartIo、割り込み |
| HwStorTimer | 割り込み (PORT_CONFIGURATION_INFORMATION の SynchronizationModel メンバーが StorSynchronizeHalfDuplex に設定されていない場合) |
| HwStorResetBus | 割り込み (PORT_CONFIGURATION_INFORMATION の SynchronizationModel メンバーが StorSynchronizeHalfDuplex に設定されていない場合) |
| HwStorAdapterControl | DPC、StartIo、割り込み。 (Windows Server 2003 では、コントロールの種類が ScsiStopAdapter の場合、スピン ロックは許可されません)。 |
| HwStorUnitControl | DPC、StartIo、割り込み |
| HwStorTracingEnabled | DPC、StartIo、割り込み |
| HwStorPassiveInitializeRoutine | なし |
| HwStorDpcRoutine | DPC、StartIo、割り込み |
| HwStorStateChange | 割り込み (PORT_CONFIGURATION_INFORMATION の SynchronizationModel メンバーが StorSynchronizeHalfDuplex に設定されていない場合) |
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| Header | storport.h (Storport.h を含む) |
| DDI コンプライアンス規則 | StorPortSpinLock(storport)、 StorPortSpinLock3(storport)、 StorPortSpinLock4(storport) |