RtndUpDown

RtndUpDown is called when the NAL requires that the driver start (or stop) a particular NIC card.

Syntax

int RtndUpDown(
    void *ndp,
    USHORT flags,
    CHAR *options
);

Parameters

ndp

Network Device Pointer.  Opaque network device identifier.

flags

Flag indicating if the network device is being started or stopped.

options

Reserved.

Return Value

A return value of 0 indicates Success, -1 indicates Failure.

Remarks

Given a flag value of non-zero, RtndUpDown will bring up the NIC. An interrupt should be attached to a vector and enabled from the card; DMA should be turned on, etc.

Given a flag value of zero, RtndUpDown will bring down the NIC card. All interrupts should be disabled from the card and interrupt vector should be released. DMA should be turned off, and the card should be placed in a safe dormant state. Event handles should be closed and all driver threads should be terminated.

RtndUpDown must call RtnGetDataLong with offset 0 to get the driver index for the interface index to bring up or down.

Process Context

RtndUpDown is always called from within the process context of the RTX64Nal process.

Requirements

Minimum Supported Version	RTX64 4.0
Header	RtnApi.h
Library	RTX64Nal.lib