vlselectevents(3dm)

NAME
     vlSelectEvents - select VL events of interest

SYNOPSIS
     #include <dmedia/vl.h>

     int vlSelectEvents(VLServer svr, VLPath path, VLEventMask eventMask);

PARAMETERS
     svr         Specifies video server.

     path        Specifies path.

     eventMask   Mask of events of interest.

DESCRIPTION
     vlSelectEvents expresses interest in knowing about events specified in
     the eventMask parameter. Event masks may be OR'd together to select
     multiple events.

     The VL defines the following event masks:

     VLNoEventsMask   All events are ignored.

     VLStreamBusyMask   The data stream is locked by another client.

     VLStreamPreemptedMask   The data stream has been taken over by another
                             client.

     VLStreamAvailableMask   The data stream has been released by another
                             client.

     VLSyncLostMask   No video synchronization is detected.

     VLStreamStartedMask   The data stream has started delivery.

     VLStreamStoppedMask   The data stream has stopped delivery.

     VLSequenceLostMask   A field or frame was missed.

     VLControlChangedMask   A control has changed.

     VLControlRangeChangedMask   The valid range for a control has changed.

     VLControlPreemptedMask   A control has been taken over (locked) by
                              another client.

     VLControlAvailableMask   A control has been released (unlocked) by
                              another client.
     VLTransferCompleteMask   The data transfer has completed.

     VLTransferFailedMask   The data transfer has failed.

     VLEvenVerticalRetraceMask   An even field vertical retrace has occurred.

     VLOddVerticalRetraceMask   An odd field vertical retrace has occurred.

     VLFrameVerticalRetraceMask   A frame vertical retrace has occurred.

     VLDeviceEventMask   A device event, e.g. external trigger, has occurred.

     VLDefaultSourceMask   The default video source has changed.


RETURN VALUE
     If successful, this function returns zero.  A value of -1 indicates an
     error.

SEE ALSO
     vlNextEvent(3dm), vlPeekEvent(3dm), vlConnectionNumber(3dm)