Method wait.forHandle

Overload

Waits for a kernel object (event, mutex, etc).

public static int forHandle(Seconds timeout, WHFlags flags, params ReadOnlySpan<nint> handles)

timeout (Seconds)

Timeout, seconds. Can be 0 (infinite), >0 (exception) or <0 (no exception). More info: Wait timeout.

flags (WHFlags)

handles (ReadOnlySpan<nint>)

One or more handles of kernel objects. Max 63.

int

Returns 1-based index of the first signaled handle. Negative if abandoned mutex. On timeout returns 0 if timeout is negative; else exception.

timeout time has expired (if > 0).

AuException

Failed. For example a handle is invalid.

Uses API WaitForMultipleObjectsEx or MsgWaitForMultipleObjectsEx. Alertable. Does not use WaitLoop and Seconds.Period/MaxPeriod.