RtkRtssAttach

RtkRtssAttach attaches a Windows 64 kernel device driver to the RTX64 Real-time Subsystem.

Syntax

NTSTATUS RtkRtssAttach(
    ULONG MaxWFSO,
    PRTSSINST RtssInstPtr,
);

Parameters

MaxWFSO

The count of the number of wait-for-single-objects the user requires. The required minimum is one.

RtssInstPtr

A pointer to a RTSSINST object that will return a non-zero value if the function succeeds, 0 if the function fails.

Return Value

RtkRtssAttach returns STATUS_SUCCESS on success or on failure one of the following NTSTATUS error codes is possible:

• STATUS_UNSUCCESSFUL
• STATUS_INVALID_PARAMETER
• STATUS_LICENSE_VIOLATION

Remarks

This call should be made only once by a kernel-resident device driver. The returned instance must be used for all subsequent RTKAPI calls. This call is usually made at, but not restricted to, driver entry, unless your device driver is set to start at boot time.

If the device driver caller starts at boot time, you must:

1. Set the RTX64 Subsystem to start at the boot time.
2. Set your driver dependencies to depend on RTX64 Subsystem (Rtx_Rtss.sys). For information on setting dependencies, see the MSDN article at http://msdn.microsoft.com/en-us/library/windows/hardware/ff552319(v=vs.85).aspx
3. Make this call ONCE in the Driver Dispatch routine, NEVER in the DriverEntry() routine.

See Also:

RtkRtssAttachEx

RtkRtssDetach