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 ルーチンに渡す必要があります。

戻り値

なし

解説

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

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

スピン ロックは次の順序で取得する必要があるため、ポート ドライバーによって保持されるロックは、コールバック ルーチンをロックするロックの取得が許可されます。

• DPC または StartIo
• 割り込み

たとえば、ポート ドライバーがコールバック ルーチンを呼び出す前に割り込みスピン ロックを取得した場合、DPC スピン ロックと StartIo スピン ロックは割り込みスピン ロックよりも低い順序であるため、そのコールバック ルーチンは DPC または StartIo スピン ロックを取得できなくなります。 一方、ポート ドライバーがコールバック ルーチンを呼び出す前に StartIo スピン ロックを取得した場合、そのコールバック ルーチンは、実行時に 割り込み または DPC スピン ロックを取得できます。

次の表は、各ミニポート ドライバー ルーチンが取得できるスピン ロックを示しています。 ミニポート ドライバー ルーチンが StartIo スピン ロックと 割り込み スピン ロックの両方を取得する必要がある場合、ルーチンは常に最初に StartIo スピン ロックを取得する必要があります。

要件

こちらもご覧ください

STOR_SPINLOCK

StorPortReleaseSpinLock