dvc_get_status()

Purpose

Obtains the status of the open device

Old name

#define dvc_status dvc_get_status

Syntax

int dvc_get_status(status)

Parameters

char* status

Pointer to an allocated area where the status can be placed

Description

The dvc_get_status() function is used in conjunction with device drivers. It describes the state of the currently open device, as determined by the last call to the function dvc_set_subdevice().

This function places a null-terminated string in the space pointed to by the status parameter. The meaning of this string is determined by the device driver protocol.

For example, a device driver may return an ASCII 0 if the current device is the cash drawer and it is closed and an ASCII 1 if it is open.

See the DP4 Device Integration Developers Manual for more information on this function.

Return values

Returns the length of the string inserted in the status area

See also

dvc_set_inp_mask(), dvc_get_inp_source(), dvc_set_subdevice()