HP UX 11i v1 I/O Cards manual Zqhdp Return param

Models: UX 11i v1 I/O Cards

1 298
Download 298 pages 31.75 Kb
Page 267
Image 267

ZCOM C I/F Library Routines

ZQSZE (3X)

PARAMETERS

zap ZCOM address

zqhdp (Return param)

ZCOM queue header data structure. This structure has the following definition:

typedef struct {

 

uint32

qnmsg;

/* Number of msgs on queue */

uint32

qlimit;

/* Max # of msgs allowed on queue */

zbhd_type

/* Pointer to 1st msg on queue */

*qhead;

 

 

zbhd_type *qtail;

/* Pointer to last msg on queue */

uint32

qmmax;

/* Historical max # of msgs on queue */

uint32

qtmsg;

/* Total # of msgs through queue */

uint32

qbytes;

/* Number of bytes on queue */

uint16

qwaiter;

/* Number of waiters on this queue */

uint16

qflag;

/* Queue flags */

uint32

qfdata;

/* Queue function data */

uint32

spare1;

/* Reserved, not used */

void

 

/* Queue function to call */

(*qfunc)();

}zqhd_type;

Note that in 32-bit mode, 32-bit padding fields are inserted before the pointer fields. These are to maintain the same layout in both 32/64-bit modes. Such padding fields are not shown here and also should not be referenced directly.

RETURN VALUE Routine zqsze returns 0 if successful. Otherwise, a non-zeroerror code is returned. See /opt/acc/include/zcom/zcomsys.h for the list of ZCOM error codes and their meanings.

Chapter 4

267

Page 267
Image 267
HP UX 11i v1 I/O Cards manual Zqhdp Return param