RtnGetDevicePtr

RtnGetDevicePtr gets the network device pointer associated with ASCII network device name. RtnGetDevicePtr is normally called in the stack configuration routine to access network device structure from network device name.

NOTE: RTSS applications must call this function to obtain the device network pointer to use an RTN API function that requires the device network pointer.

Syntax

VOID * RtnGetDevicePtr(
    VOID *pBuffer,
    RTN_DEVICE_QUERY eVal,
);

Parameters

pBuffer

A pointer to a buffer containing a zero-terminated ASCII network adapter friendly name or adapter MAC address.

eVal

The RTN_DEVICE_QUERY type specifying the pBuffer pointer is either RTN_DEVICE_QUERY_BY_NAME, a network adapter friendly name, or RTN_DEVICE_QUERY_BY_MAC adapter MAC address.

Return Value

An opaque network device pointer if the function succeeds, NULL if the function fails

Requirements

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