njb_capture(3)

NAME

NJB_Capture, NJB_Release - Capture or release an NJB

LIBRARY

libnjb

SYNOPSIS

#include <libnjb.h>
extern int njb_error
NJB_Capture (njb_t *njb)
NJB_Release (njb_t *njb)

DESCRIPTION

The NJB_Capture function "captures" the NJB device, which

locks out the control buttons on the device itself. Any attempt

to use the NJB controls directly will result in a "HOST IS IN

CONTROL" message on the LCD screen.

Capturing the NJB is an essential part of the session,

since you want to ensure that only the controlling software can

modify the contents of the device.

*njb must be an njb object that was previously opened via

NJB_Open

To release the NJB, use the NJB_Release command.

RETURN VALUES

Both functions return 0 upon success, and return -1 and

set njb_error on failure:

EO_USBCTL An I/O error occured when speaking on the con

trol pipe

EO_BADSTATUS

The NJB returned a "failure" status in response

to the capture or release command.

SEE ALSO

NJB_Open(3)

March 2001

NJB_CAPTURE(3)