Direct Access Transport Library Functions   datevdpostse(3DAT)



NAME
     datevdpostse  -  post  Software  event   to   the   Event
     Dispatcher event queue

SYNOPSIS
     cc [ flag... ] file... -ldat [ library... ]
     #include 

     DATRETURN
         datevdpostse(
         IN        DATEVDHANDLE    evdhandle,
         IN const  DATEVENT         *event
         )


PARAMETERS
     evdhandle    Handle for an instance of the Event Dispatcher


     event         A  pointer  to  a  Consumer  created  Software
                   Event.


DESCRIPTION
     The datevdpostse() function posts Software events to  the
     Event  Dispatcher  event  queue.  This is analogous to event
     arrival on the Event Dispatcher software Event  Stream.  The
     event that the Consumer provides adheres to the event format
     as defined in . The first element in the  event  pro-
     vides  the  type of the event (DATEVENTYPESOFTWARE); the
     rest  provide  the  event-type-specific  parameters.   These
     parameters  are opaque to a Provider. Allocation and release
     of the memory referenced by the event pointer in a  software
     event are the Consumer's responsibility.


     There is no ordering between  events  from  different  Event
     Streams.  All  the  synchronization  issues between multiple
     Consumer  contexts  trying  to  post  events  to  an   Event
     Dispatcher instance simultaneously are left to a Consumer.


     If the event queue  is  full,  the  operation  is  completed
     unsuccessfully  and returns DATQUEUEFUL. The event is not
     queued. The queue overflow condition does takes  place  and,
     therefore,   the   asynchronous   Event  Dispatcher  is  not
     effected.

RETURN VALUES
     DATSUCES              The operation was successful.





SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions   datevdpostse(3DAT)



     DATINVALIDHANDLE       The   evdhandle    parameter    is
                              invalid.


     DATINVALIDPARAMETER    The event parameter is invalid.


     DATQUEUEFUL           The Event Dispatcher queue is full.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard: uDAPL, 1.1, 1.2   
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     libdat(3LIB), attributes(5)




























SunOS 5.11          Last change: 16 Jul 2004                    2