1dat_evd_post_se(3DATD)irect Access Transport Library Functiodnast_evd_post_se(3DAT)
2
3
4

NAME

6       dat_evd_post_se  -  post  Software  event to the Event Dispatcher event
7       queue
8

SYNOPSIS

10       cc [ flag... ] file... -ldat [ library... ]
11       #include <dat/udat.h>
12
13       DAT_RETURN
14           dat_evd_post_se(
15           IN        DAT_EVD_HANDLE    evd_handle,
16           IN const  DAT_EVENT         *event
17           )
18
19

PARAMETERS

21       evd_handle    Handle for an instance of the Event Dispatcher
22
23
24       event         A pointer to a Consumer created Software Event.
25
26

DESCRIPTION

28       The dat_evd_post_se() function posts Software events to the Event  Dis‐
29       patcher  event  queue.  This is analogous to event arrival on the Event
30       Dispatcher software Event Stream. The event that the Consumer  provides
31       adheres to the event format as defined in <dat.h>. The first element in
32       the event provides the type of the event (DAT_EVENT_TYPE_SOFTWARE); the
33       rest  provide  the event-type-specific parameters. These parameters are
34       opaque to a Provider. Allocation and release of the  memory  referenced
35       by  the  event pointer in a software event are the Consumer's responsi‐
36       bility.
37
38
39       There is no ordering between events from different Event  Streams.  All
40       the synchronization issues between multiple Consumer contexts trying to
41       post events to an Event Dispatcher instance simultaneously are left  to
42       a Consumer.
43
44
45       If  the  event queue is full, the operation is completed unsuccessfully
46       and returns DAT_QUEUE_FULL. The event is not queued. The queue overflow
47       condition  does takes place and, therefore, the asynchronous Event Dis‐
48       patcher is not effected.
49

RETURN VALUES

51       DAT_SUCCESS              The operation was successful.
52
53
54       DAT_INVALID_HANDLE       The evd_handle parameter is invalid.
55
56
57       DAT_INVALID_PARAMETER    The event parameter is invalid.
58
59
60       DAT_QUEUE_FULL           The Event Dispatcher queue is full.
61
62

ATTRIBUTES

64       See attributes(5) for descriptions of the following attributes:
65
66
67
68
69       ┌─────────────────────────────┬─────────────────────────────┐
70       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
71       ├─────────────────────────────┼─────────────────────────────┤
72       │Interface Stability          │Standard: uDAPL, 1.1, 1.2    │
73       ├─────────────────────────────┼─────────────────────────────┤
74       │MT-Level                     │Unsafe                       │
75       └─────────────────────────────┴─────────────────────────────┘
76

SEE ALSO

78       libdat(3LIB), attributes(5)
79
80
81
82SunOS 5.11                        16 Jul 2004            dat_evd_post_se(3DAT)
Impressum