| Prototype |
|
NTSTATUS DiMgslOpen( char *Name,
void**Handle,
DICALLBACKS *Callbacks );
|
| Parameters |
|
Name
|
NULL terminated device name |
Handle
|
returned device handle |
Context
|
pointer to DICALLBACKS structure |
| Return Value |
|
STATUS_SUCCESS
|
Port successfully opened |
STATUS_BUSY
|
Port is in use by another application |
STATUS_NO_SUCH_DEVICE
|
Port does not exist or is not functioning |
Open a port and return a handle to the port which can be used with
other API functions. Call DiMgslClose when the device is no longer needed.
Only one handle per port may be open. This prevents contention when
accessing a port that is currently in use.