RtkSetEvent

RtkSetEvent sets the state of the specified event object to signaled.

Syntax

Copy

NTSTATUS RtkSetEvent(
    [in]    RTSSINST RtssInst,
    [in]    HANDLE EventHandle,
);

Parameters

[in] RtssInst

An RTSSINST value returned from a call to RtkRtssAttach or RtkRtssAttachEx. Pass a valid RTSSINST value or the call will fail with STATUS_INVALID_PARAMETER.

[in] EventHandle

The handle that identifies the event object is returned by a preceding call to RtkCreateEvent or RtkOpenEvent.

Return Value

If the function succeeds, it returns STATUS_SUCCESS. If the function fails, it returns one of the following NTSTATUS error codes:

STATUS_INVALID_PARAMETER
STATUS_UNSUCCESSFUL
STATUS_INVALID_HANDLE

Remarks

The state of a manual-reset event object remains signaled until it is set explicitly to the non-signaled state by the RtkSetEvent function. Any number of waiting threads, or threads that subsequently begin wait operations for the specified event object by calling the wait functions, can be released while the object's state is signaled.

The state of an auto-reset event object, the function resets the state to non-signaled and returns after releasing remains signaled until a single waiting thread is released. At that time, the system automatically sets the state to non-signaled. If no threads are waiting, the event object's state remains signaled.

Requirements

Minimum supported version	Header	Library	IRQL
wRTOS 1.0 SDK	RtkApi.h	RtkApi_W64.lib	PASSIVE_LEVEL