dat_evd_resize(3DATDirect Access Transport Library Functiodat_evd_resize(3DAT)NAMEdat_evd_resize - modify the size of the event queue of Event Dispatcher
SYNOPSIS
cc [ flag... ] file... -ldat [ library... ]
#include <dat/udat.h>
DAT_RETURN
dat_evd_resize(
IN DAT_EVD_HANDLE evd_handle,
IN DAT_COUNT evd_min_qlen
)
PARAMETERS
evd_handle Handle for an instance of Event Dispatcher.
evd_min_qlen New number of events the Event Dispatcher event queue
must hold.
DESCRIPTION
The dat_evd_resize() function modifies the size of the event queue of
Event Dispatcher.
Resizing of Event Dispatcher event queue should not cause any incoming
or current events on the event queue to be lost. If the number of
entries on the event queue is larger then the requested evd_min_qlen,
the operation can return DAT_INVALID_STATE and not change an instance
of Event Dispatcher
RETURN VALUES
DAT_SUCCESS The operation was successful.
DAT_INVALID_HANDLE The evd_handle parameter is invalid.
DAT_INVALID_PARAMETER The evd_min_qlen parameter is invalid
DAT_INSUFFICIENT_RESOURCES The operation failed due to resource
limitations
DAT_INVALID_STATE Invalid parameter. The number of
entries on the event queue of the Event
Dispatcher exceeds the requested event
queue length.
USAGE
This operation is useful when the potential number of events that could
be placed on the event queue changes dynamically.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Standard: uDAPL, 1.1, 1.2 │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │Unsafe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOlibdat(3LIB), attributes(5)SunOS 5.10 16 Jul 2004 dat_evd_resize(3DAT)