RtnRequest

RtnRequest forwards a request to the underlying driver to query the requested capabilities and/or statistics of the RTX64-converted NIC card.

Syntax

VOID RtnRequest (
    PRTND_STATUS Status,
    PCHAR DeviceName,
    PRTND_REQUEST RtndReq
);

Parameters

Status

The RTND_STATUS type set on return from this function which reflects status of RtnRequest.

DeviceName

Zero terminated ASCII network adapter friendly name.

RtndReq

The RTND_REQUEST type specifying RTX64 network adapter capabilities and statistics to request.

Return Value

None.

Remarks

The RTND_OID field of the RTND_REQUEST structure is used to define the request type.

Example

#include <winsock2.h>

#include <ws2tcpip.h>

#include <wchar.h>

#include <rtapi.h>

#include <rtnapi.h>

 

void main(int argc, char **argv)

{

RTND_STATUS Status;

RTND_REQUEST RtndRequest;

RTND_MEDIA_CONNECT_STATE State;

 

RtndRequest.Oid = RTND_OID_GEN_MEDIA_CONNECT_STATUS;

RtndRequest.InformationBuffer = &State;

RtndRequest.InformationBufferLength = sizeof(RTND_MEDIA_CONNECT_STATE);

 

RtnRequest(&Status, "RtE1000", &RtndRequest);

 

RtPrintf("Status 0x%x Info buffer 0x%x\n", Status, RtndRequest.InformationBuffer);

 

ExitProcess(0);

}

Requirements

Minimum Supported Version RTX64 2014
Header rtnapi.h
Library RtTcpip.lib

See Also:

RTND_STATUS type

RTND_REQUEST structure

RTND_MEDIA_CONNECT_STATE enumeration

RTND_MEDIA_DUPLEX_STATE enumeration

RTND_MEDIA_SPEED enumeration