Prosoft-technology MVI69-ADMNET Bedienungsanleitung PDF herunterladen (Seite 65)

MVI-ADMNET ♦ 'C' Programmable Application Development Function Library - ADMNET API

'C' Programmable Application Development Module with Ethernet Developer's Guide

ProSoft Technology, Inc. Page 65 of 122

February 20, 2013

5.2 ADMNET API Initialize Functions

The following topics describe the ADMNET API Initialize functions.

ADM_init_socket

Syntax

int ADM_init_socket(int numSK, int portNum, int buffSize, char *name);

Parameters

numSK

Variable indicating how many sockets to use.

portNum

Port Number.

buffSize

The size of the buffer available in each socket.

name

The name of the socket.

Description

ADM_init_socket acquires access to the ADMNET API and dynamically

generates a set of sockets according to numSK and assigns portNum, buffSize,

then names each socket that the application will use in subsequent functions.

This function must be called before any of the other API functions can be used.

IMPORTANT After the API has been opened, ADM_Release_Sockets should always be called

before exiting the application.

Return Value

SK_SUCCESS

API has successfully initialized variables.

SK_PORT_NOT_ALLOW

API does not allow port number used.

SK_CANNOT_ALLOCATE_MEMORY

API cannot allocate memory.

Example

int numSK = 5;

int portNum = 5757;

int buffSize = 1000;

if(ADM_init_socket(numSK, portNum, buffSize, "ReceiveSK") != SK_SUCCESS)

{

printf("\nFailed to open ADM API... exiting program\n");

ADM_release_sockets();

}

Keine Kommentare

Prosoft-technology MVI69-ADMNET Bedienungsanleitung Seite 65