This endpoint is intended for working with notifications about events that occur with resources.
Information about methods of the endpoint is provided in the table below.
Methods of the notice.Notice endpoint (kl.core.Notice interface)
Method
Method purpose and parameters
Potential danger of the method
Create
Purpose
Creates a notification receiver.
Parameters
[out] notify – value whose binary representation consists of multiple fields, including a handle field and a handle permissions mask field. The handle identifies the notification receiver.
[out] rc – return code.
Allows the kernel memory to be used up by creating a multitude of objects within it.
SubscribeToObject
Purpose
Adds a "resource–event mask" entry to the notification receiver so that it can receive notifications about events that occur with the defined resource and match the defined event mask.
Parameters
[in] notify – value whose binary representation consists of multiple fields, including a handle field and a handle permissions mask field. The handle identifies the notification receiver.
[in] object – value whose binary representation consists of multiple fields, including a handle field and a handle permissions mask field. The handle identifies the resource.
[in] evMask – event mask.
[in] evId – ID of the "resource–event mask" entry. It is used to identify the entry in received notifications.
[out] rc – return code.
Allows the kernel memory to be used up by creating a multitude of objects within it.
UnsubscribeFromEvent
Purpose
Deletes notifications matching a "resource–event mask" entry with the defined ID from the notification receiver.
Parameters
[in] notify – value whose binary representation consists of multiple fields, including a handle field and a handle permissions mask field. The handle identifies the notification receiver.
[in] evId – ID of the "resource–event mask" entry.
[out] rc – return code.
N/A
UnsubscribeFromObject
Purpose
Deletes notifications matching the defined resource from the notification receiver.
Parameters
[in] notify – value whose binary representation consists of multiple fields, including a handle field and a handle permissions mask field. The handle identifies the notification receiver.
[in] object – value whose binary representation consists of multiple fields, including a handle field and a handle permissions mask field. The handle identifies the resource.
[out] rc – return code.
N/A
GetEvent
Purpose
Extracts notifications from the receiver.
Parameters
[in] notify – value whose binary representation consists of multiple fields, including a handle field and a handle permissions mask field. The handle identifies the notification receiver.
[in] mdelay – timeout for notifications to appear in the receiver, in milliseconds.
[out] evId – ID of the "resource–event mask" entry matching the resource for which the notifications are extracted.
[out] evMask – mask of events that occurred with the resource.
[out] rc – return code.
N/A
DropAndWake
Purpose
Deletes all "resource–event mask" entries from the defined notification receiver, resumes execution of all threads awaiting an event associated with the defined notification receiver, and (optionally) prohibits the addition of "resource–event mask" entries to the defined notification receiver.
Parameters
[in] notify – value whose binary representation consists of multiple fields, including a handle field and a handle permissions mask field. The handle identifies the notification receiver.
[in] finish – value defining whether or not the addition of "resource–event mask" entries will be prohibited (0 – will not be prohibited, 1 – will be prohibited).
[out] rc – return code.
N/A
SetObjectEvent
Purpose
Signals that events from the defined event mask occurred with the defined user resource.
Parameters
[in] object – value whose binary representation consists of multiple fields, including a handle field and a handle permissions mask field. The handle identifies the user resource.