PlatformEvent.c File Reference

Implementation of cross platform APIs for kernel event and object management. More...

#include "pch.h"

Functions
VOID	PlatformObjectDereference (PVOID Object)
	Dereference a kernel object, decrementing its reference count.
LONG	PlatformEventSet (PKEVENT Event, KPRIORITY Increment, BOOLEAN Wait)
	Signal (set) a kernel event object.
NTSTATUS	PlatformObjectReferenceByHandle (HANDLE Handle, ACCESS_MASK DesiredAccess, POBJECT_TYPE ObjectType, KPROCESSOR_MODE AccessMode, PVOID *Object, POBJECT_HANDLE_INFORMATION HandleInformation)
	Obtain a pointer to a kernel object by its user-mode handle and increment its reference count.

Detailed Description

Implementation of cross platform APIs for kernel event and object management.

Author

Sina Karvandi (sina@.nosp@m.hype.nosp@m.rdbg..nosp@m.org)

Version

0.19

Date

2026-05-09

Copyright

This project is released under the GNU Public License v3.

Function Documentation

PlatformEventSet()

LONG PlatformEventSet	(	PKEVENT	Event,
		KPRIORITY	Increment,
		BOOLEAN	Wait )

Signal (set) a kernel event object.

Parameters

Event	Pointer to the KEVENT to signal
Increment	Priority increment for any waiting threads to be awakened
Wait	If TRUE, the caller intends to immediately call a wait routine after this call

Returns

LONG The previous signal state of the event

{
#if defined(_WIN32) || defined(_WIN64)
 
    return KeSetEvent(Event, Increment, Wait);
 
#elif defined(__linux__)
 
#    error "Not yet implemented"
 
#else
 
#    error "Unsupported platform"
 
#endif
}

PlatformObjectDereference()

VOID PlatformObjectDereference

(

PVOID

Object

)

Dereference a kernel object, decrementing its reference count.

Parameters

Object

Pointer to the kernel object to dereference

Returns

VOID

{
#if defined(_WIN32) || defined(_WIN64)
 
    ObDereferenceObject(Object);
 
#elif defined(__linux__)
 
#    error "Not yet implemented"
 
#else
 
#    error "Unsupported platform"
 
#endif
}

PlatformObjectReferenceByHandle()

NTSTATUS PlatformObjectReferenceByHandle	(	HANDLE	Handle,
		ACCESS_MASK	DesiredAccess,
		POBJECT_TYPE	ObjectType,
		KPROCESSOR_MODE	AccessMode,
		PVOID *	Object,
		POBJECT_HANDLE_INFORMATION	HandleInformation )

Obtain a pointer to a kernel object by its user-mode handle and increment its reference count.

Parameters

Handle	User-mode handle referencing the kernel object
DesiredAccess	Access mask for the requested access rights
ObjectType	Pointer to the object type object (e.g., *ExEventObjectType); NULL to skip type check
AccessMode	Processor mode to use for access checks (KernelMode or UserMode)
Object	Receives a pointer to the referenced kernel object body
HandleInformation	Optional; receives access state information

Returns

NTSTATUS STATUS_SUCCESS on success, or an error code on failure

{
#if defined(_WIN32) || defined(_WIN64)
 
    return ObReferenceObjectByHandle(Handle,
                                     DesiredAccess,
                                     ObjectType,
                                     AccessMode,
                                     Object,
                                     HandleInformation);
 
#elif defined(__linux__)
 
#    error "Not yet implemented"
 
#else
 
#    error "Unsupported platform"
 
#endif
}