RtnInitializeCriticalLock

RtnInitializeCriticalLock initializes a CriticalLock data structure. CriticalLock data structures must be initialized once before RtnEnterCriticalLock and RtnLeaveCriticalLock can be used. Normally, all CriticalLock structures are initialized in RtndConfigure.

Since the individual RtxTcpIp NIC Drivers operate as RTDLLs, the process context at any given time is not determined. Because of this, normal synchronization mechanisms such as critical sections or semaphores are difficult to use. The CriticalLock structure is guaranteed to work across all process and thread boundaries and so can be used to synchronize hardware access within RtxTcpIp NIC Drivers without having to deal with process local handles (such as those used by RTX critical sections and semaphores).

Syntax

void RtnInitializeCriticalLock(
    CriticalLock *pLock
);

Parameters

pLock

Pointer to a critical lock data structure

Return Values

None.

Requirements

Header	Drvutl.h
Library	Rtxtcpip.lib

| |