User`s guide

ldv-open
Purpose
Initializes the network interface hardware for access by a Windows application. A
Windows application can open multiple network interfaces. In the case of DOS
drivers, this is done by loading multiple drivers in CONFIG. SYS. Initialization
required to prepare the SLTA-10 Adapter is performed by this function. Different
drivers and hardware interfaces could require different initialization and
configuration requirements. Each driver must provide its own mechanism for
providing these services. In the case of DOS device drivers, this is assumed to be
command line options specified at the time the driver is loaded.
Note: A driver should only allow itself to be opened once. If the driver is already
open, it should return the error value 2.
Syntax
#include <ldv.h>
short ldv-open(char far *device-id-p, short far *handle)
See Also
ldv-close0
Returns
LDV-OK (0)
Device successfully opened.
LDV-NOT-FOUND (1) Hardware does not exist or is not accessible.
LDV-ALREADY-OPEN (2)
Device already open.
LDV-DEVICE-ERR (4) Error occurred accessing device.
LDV-INVALID-DEVICE-ID (5) InvaliddeviceID.
LDV-NO-RESOURCES (8)
No device handles available.
Parameters
device-id-p char far *
Pointer to a character string identifying the network
interface hardware device to be accessed. The
following naming conventions are used to identify the
type of device driver being used:
LONn
DOS Device Driver named LONG,
where n is a number from 1 to 9.
handle short far *
Pointer to an integer in which the open function will
return a handle to be used to identify this device in
other driver functions.
Appendix A