StorPortAcquireSpinLockEx 함수(storport.h)

StorPortAcquireSpinLockEx 루틴은 지정된 스핀 잠금을 획득합니다.

구문

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

매개 변수

HwDeviceExtension

[in] 어댑터별 미니포트 드라이버 디바이스 확장에 대한 포인터입니다.

SpinLock

[in] 획득할 스핀 잠금을 지정하는 STOR_SPINLOCK 형식의 열거자 값을 지정합니다.

LockContext

[in] SpinLock 이 DpcLock으로 설정된 경우 잠금이 유지되는 DPC 개체에 대한 포인터입니다. SpinLock이 InterruptLock 또는 StartIoLock 형식을 나타내는 경우 이 멤버는 NULL이어야 합니다.

LockHandle

[in/out] 반환할 때 잠금 핸들을 포함하는 버퍼에 대한 포인터입니다. 잠금을 해제하려면 호출자가 이 핸들을 StorPortReleaseSpinLock 루틴에 전달해야 합니다.

반환 값

스핀 잠금이 성공적으로 획득되면 StorPortAcquireSpinLockEx는 STOR_STATUS_SUCCESS 반환합니다. 그렇지 않으면 다음 중 하나와 같은 상태 코드를 반환합니다.

설명

미니포트 드라이버는 이미 보유하고 있는 잠금을 획득하거나 잘못된 순서로 잠금을 획득하지 않도록 해야 합니다. 이러한 실수 중 하나라도 시스템 교착 상태가 발생합니다.

특정 잠금은 포트 드라이버가 미니포트 드라이버 콜백 루틴을 호출하기 전에 자동으로 유지됩니다. 각 미니포트 드라이버 콜백 루틴에 대해 다음 표는 콜백 루틴을 호출하기 전에 포트 드라이버가 자동으로 획득하는 잠금을 나타냅니다.

다음 순서로 스핀 잠금을 획득해야 하므로 콜백 루틴을 잠그는 포트 드라이버의 영향을 받는 잠금을 획득할 수 있습니다.

• DPC 또는 StartIo
• Interrupt

instance 경우 포트 드라이버가 콜백 루틴을 호출하기 전에 인터럽트 스핀 잠금을 획득하는 경우 DPC 및 StartIo 스핀 잠금이 인터럽트 스핀 잠금보다 낮은 순서이므로 해당 콜백 루틴은 더 이상 DPC 또는 StartIo 스핀 잠금을 획득할 수 없습니다. 반면, 포트 드라이버가 콜백 루틴을 호출하기 전에 StartIo 스핀 잠금을 획득하는 경우 해당 콜백 루틴이 실행될 때 인터럽트 또는 DPC 스핀 잠금을 획득할 수 있습니다.

다음 표에서는 각 미니포트 드라이버 루틴에서 획득할 수 있는 스핀 잠금을 나타냅니다. 미니포트 드라이버 루틴이 StartIo 스핀 잠금과 인터럽트 스핀 잠금을 모두 가져와야 하는 경우 루틴은 항상 StartIo 스핀 잠금을 먼저 획득해야 합니다.

요구 사항

추가 정보

STOR_SPINLOCK

StorPortReleaseSpinLock