RtkRtssAttach

RtkRtssAttach attaches a kernel device driver to RTSS.

Syntax

RTSSINST RtkRtssAttach(
    LONG MaxWFSO,
    PULONG pErrorCode,
);

Parameters

MaxWFSO

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

pErrorCode

A pointer to a location where additional error information may be returned. This location need not be defined; the user may pass a NULL value. If defined, this location is set to NULL if no error occurred.

Return Values

A non-zero RTSSINST if the function succeeds, 0 (zero) if the function fails

Remarks

This call is 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.

If the device driver caller starts at boot time - you have to, first, set RTX to start at the boot time, and second, make this call ONCE in the Driver Dispatch routine, NEVER in the DriverEntry() routine.

Requirements

Header	Rtkapi.h
Library	rtx_rtk.lib