KeReleaseSemaphore 함수(wdm.h)

KeReleaseSemaphore 루틴은 지정된 세마포 개체를 해제합니다.

구문

LONG KeReleaseSemaphore(
  [in, out] PRKSEMAPHORE Semaphore,
  [in]      KPRIORITY    Increment,
  [in]      LONG         Adjustment,
  [in]      BOOLEAN      Wait
);

매개 변수

[in, out] Semaphore

호출자가 스토리지를 제공하는 초기화된 세마포 개체에 대한 포인터입니다.

[in] Increment

세마포를 해제하면 대기가 충족될 경우 적용할 우선 순위 증분을 지정합니다.

[in] Adjustment

현재 세마포 수에 추가할 값을 지정합니다. 이 값은 양수여야 합니다.

[in] Wait

KeReleaseSemaphore 호출 바로 뒤에 KeWaitXxx 루틴 중 하나를 호출할지 여부를 지정합니다. TRUE 이면 KeReleaseSemaphore 호출 뒤에 KeWaitForMultipleObjects, KeWaitForMutexObject 또는 KeWaitForSingleObject를 호출해야 합니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

반환 값

반환 값이 0이면 세마포 개체의 이전 상태는 신호를 받지 않습니다.

설명

KeReleaseSemaphore 는 대기 스레드에 대한 런타임 우선 순위 향상을 제공합니다. 이 호출이 세마포를 신호 상태로 설정하면 세마포 수가 지정된 값으로 보강됩니다. 호출자는 KeReleaseSemaphore 가 컨트롤을 반환하는 즉시 KeWaitXxx 루틴 중 하나를 호출할지 여부를 지정할 수도 있습니다.

세마포 개체를 해제하면 세마포 수가 Adjustment 매개 변수 값으로 보강됩니다. 결과 값이 세마포 개체의 한도보다 크면 개수가 조정되지 않고 예외(STATUS_SEMAPHORE_LIMIT_EXCEEDED)가 발생합니다.

세마포 개체 수를 보강하면 세마포가 신호 상태를 달성하게 되며, 세마포 개체에서 가능한 한 많은 대기를 충족하려고 시도합니다.

KeReleaseSemaphore 루틴은 일시적으로 IRQL을 올릴 수 있습니다. Wait 매개 변수가 FALSE 이면 반환되기 전에 루틴이 호출 시작 시 있던 원래 값으로 IRQL을 복원합니다.

WaitTRUE = 이면 IRQL을 낮추지 않고 루틴이 반환됩니다. 이 경우 KeReleaseSemaphore 호출 바로 뒤에 KeWaitXxx 호출이 있어야 합니다. WaitTRUE = 를 설정하면 호출자는 KeReleaseSemaphore 호출과 KeWaitXxx 호출 간에 불필요한 컨텍스트 전환이 발생하지 않도록 방지할 수 있습니다. KeWaitXxx 루틴은 반환되기 전에 KeReleaseSemaphore 호출을 시작할 때 IRQL을 원래 값으로 복원합니다. IRQL은 두 호출 간의 컨텍스트 전환을 사용하지 않도록 설정하지만 이러한 호출은 원자성 작업의 시작과 끝으로 안정적으로 사용할 수 없습니다. 예를 들어 이러한 두 호출 사이에 다른 프로세서에서 동시에 실행되는 스레드는 세마포 개체의 상태 또는 대기 대상의 상태를 변경할 수 있습니다.

세마포 개체에 대한 자세한 내용은 세마포 개체를 참조하세요.

Wait 가 FALSE 로 설정된 경우 KeReleaseSemaphore 의 호출자는 IRQL <= DISPATCH_LEVEL 실행되어야 합니다. 그렇지 않으면 호출자가 IRQL = PASSIVE_LEVEL 실행되어야 합니다.

요구 사항

지원되는 최소 클라이언트	Windows 2000부터 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	주의 섹션을 참조하세요.
DDI 규정 준수 규칙	HwStorPortProhibitedDDIs(storport)

참고 항목

KeInitializeSemaphore

KeReadStateSemaphore

KeWaitForMultipleObjects

KeWaitForSingleObject