Error handling functions, Al_seterronreinitrunning – Measurement Computing ADLIB WIN User Manual

Page 145

Advertising
background image

Chapter 42 Error Handling Functions

29-1

29. ERROR HANDLING FUNCTIONS

The Error Handling functions allow the user to determine when a specific error should or should not occur.
In addition the current status of a device may be obtained.

29.1 AL_SetErrOnReInitRunning

Prototype

C\C++

ERRNUM

AL_SetErrOnReInitRunning(LHLD

lhld, long lState);


Visual Basic for Windows

Function

AL_SetErrOnReInitRunning(ByVal

lhld As Long,

ByVal lState As Long) As Long

LHLD lhld

handle of the LDSD

long lState

specifies the re-initialization state


The AL_SetErrOnReInitRunning function sets the hardware re-initialization authorization of the LDSD.
Essentially this function affects whether the AL_InitDevice function is allowed to initialize a hardware
device while the device itself is in a running state.

Parameter

Description

lhld

Identifies the instance of the logical device subsystem.


lState

Specifies the re-initialization authorization state of the LDSD. The available

settings are defined in the ADLIB include file as follows:

“ALLOW_REINIT”

The device will first be stopped and then

reinitialized

to

the

current

settings.

“DISALLOW_REINIT“

Reinitialization of the device will not be

allowed when the device is running and will

return

an

error.


Returns:
On success ERRNUM is set to 1, otherwise ERRNUM contains the last error code that occurred during the
call.

Supported Logical Device Subsystems:
All Boards

Advertising