Wait_Semaphore

include vmm.inc

mov eax, Semaphore ; semaphore handle

mov ecx, Flags ; flags for servicing interrupts

VMMcall Wait_Semaphore


The Wait_Semaphore service blocks the current virtual machine until the semaphore is signaled using the Signal_Semaphore service.

Parameters

Semaphore

Specifies a handle identifying the semaphore on which to wait.

Flags

Specifies actions to take when interrupts occur while the virtual machine is blocked waiting for the semaphore. This parameter can be a combination of the following values:

Value Meaning

Block_Enable_Ints Service interrupts in the virtual machine even if the virtual machine does not currently have interrupts enabled. This forces interrupts to be enabled. This value is only relevant if either Block_Svc_Ints or Block_Svc_If_Ints_Locked is set.
Block_Poll Do not switch away from the blocked virtual machine unless another virtual machine has higher priority.
Block_Svc_If_Ints_Locked Service interrupts in the virtual machine even if the virtual machine is blocked, and the VMStat_V86IntsLocked flag is set.
Block_Svc_Ints Service interrupts in the virtual machine even if the virtual machine is blocked.

Return Value

This service has no return value.

Comments

This service blocks if the semaphore's unblock count is zero, and the token count is zero or less. Otherwise, it decrements the token count and returns immediately. If the unblock count is not zero (meaning the Signal_Semaphore service has been called), Wait_Semaphore decrements the unblock count and returns immediately.

Uses

Flags

See Also

Create_Semaphore, Signal_Semaphore