Windows Driver IPC API (RTKAPI) Overview

The Windows Driver Interprocess Communication API (RTKAPI) functions are used to access RTX64 IPC mechanisms from Windows kernel device drivers. These RTKAPI calls are analogous to their RTAPI counterparts. For example, RtkOpenSemaphore is analogous to RtOpenSemaphore.

You use the RTKAPI functions the same way as the RTAPI functions, but from the Windows kernel environment. All RTKAPI interface names are prefixed with Rtk.

The RTKAPI also consists of an include file (RtkApi.h) and a link library (RtkApi.lib).

NOTE: RTK functions can be called only at the PASSIVE_LEVEL of a Windows Device Driver.

IMPORTANT! RtkAPI calls do not support subsystem dependencies that exist when using RTAPI calls. You must ensure that the subsystem has been started before your driver is started.

Building RTK Drivers

To build RTX64 RTK drivers to run on Windows 7 and above, you need to install Visual Studio 2015 and Windows Driver Kit (WDK) 10.

Please note the following installation requirements:

NOTE: Since the RTX64 Subsystem is built with Windows Driver Kit (WDK) 10, we recommend that you not use previous WDK versions to build RTK drivers.

NOTE: If you encounter errors relating to headers and libs while building RTK drivers, ensure that the installed versions of the WDK and Windows SDK match, and also ensure that the Target Platform Version setting in Visual Studio 2015 (Configuration Properties > General > Target Platform Version) is set to the correct version number.

 

See Also