次の方法で共有

StorPortAcquireSpinLockEx 関数 (storport.h)

  • [アーティクル]

StorPortAcquireSpinLockEx ルーチンは、指定されたスピン ロックを取得します。

構文

ULONG StorPortAcquireSpinLockEx(
  PVOID             HwDeviceExtension,
  STOR_SPINLOCK     SpinLock,
  PVOID             LockContext,
  PSTOR_LOCK_HANDLE LockHandle
);

パラメーター

HwDeviceExtension

[入力]アダプターごとのミニポート ドライバーデバイス拡張機能へのポインター。

SpinLock

[入力]取得するスピン ロックを指定 するSTOR_SPINLOCK 型の列挙子値を指定します。

LockContext

[入力] SpinLock が DpcLock に設定されている場合にロックが保持される DPC オブジェクトへのポインター。 SpinLock が InterruptLock または StartIoLock のいずれかの型を示す場合、このメンバーは NULL である必要があります。

LockHandle

[入力/出力]返されたバッファーへのポインターには、ロック ハンドルが含まれます。 ロックを解除するには、呼び出し元がこのハンドルを StorPortReleaseSpinLock ルーチンに渡す必要があります。

戻り値

StorPortAcquireSpinLockEx は、スピン ロックが正常に取得された場合にSTOR_STATUS_SUCCESSを返します。 それ以外の場合は、次のいずれかの状態コードが返されます。

status code 説明
STOR_STATUS_INVALID_PARAMETER パラメーターが無効です。
STOR_STATUS_INVALID_IRQL 呼び出し元は、取得しようとしている SpinLock の種類に対して無効な IRQL にあります。

注釈

ミニポート ドライバーは、既に保持されているロックを取得したり、正しくない順序でロックを取得したりしないようにする必要があります。 どちらの間違いでも、システム のデッドロックが発生します。

特定のロックは、ミニポート ドライバーのコールバック ルーチンを呼び出す前に、ポート ドライバーによって自動的に保持されます。 ミニポート ドライバーコールバック ルーチンごとに、次の表は、コールバック ルーチンを呼び出す前に、ポート ドライバーが自動的に取得するロックを示します。

ミニポート ドライバー ルーチン ポート ドライバーによって保持されるスピン ロック
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 に設定されていない場合)

要件

要件 値
サポートされている最小のクライアント Windows 10 Version 1809
Header storport.h

こちらもご覧ください

STOR_SPINLOCK

StorPortReleaseSpinLock