'\"macro stdmacro
.if n .pH ddi_dki.strqget @(#)strqget	40.6 of 10/10/89
.\" Copyright 1989 AT&T
.de IX
.ie '\\n(.z'' .tm .Index: \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9	\\n%
.el \\!.IX \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
..
.nr X
.if \nX=0 .ds x} strqget D3DK "STREAMS" "DDI/DKI" "\&"
.if \nX=1 .ds x} strqget D3DK "STREAMS" "DDI/DKI"
.if \nX=2 .ds x} strqget D3DK "" "\&"
.if \nX=3 .ds x} strqget "" "" "\&"
.TH \*(x}
.IX "\f4strqget\fP(D3DK)
.SH NAME
\f4strqget\f1 \- get information about a queue or band of the queue
.SH SYNOPSIS
.nf
.na
\f4#include <sys/stream.h>
.sp 0.5
int strqget(queue_t *\f2q, \f4qfields_t \f2what, \f4unsigned char \f2pri,
	\f4long *\f2valp\f4);\f1
.ad
.fi
.SH ARGUMENTS
.RS 0n 10
.IP "\f2q\f1" 10n
Pointer to the queue
.IP "\f2what\f1" 10n
Which field of the \f4queue\fP
structure to return information about.
Valid values are specified in \f4stream.h\fP:
.P
.RS 14
.ft 4
.nf
typedef enum qfields {
        QHIWAT   = 0,   /* q_hiwat or qb_hiwat */
        QLOWAT   = 1,   /* q_lowat or qb_lowat */
        QMAXPSZ  = 2,   /* q_maxpsz */
        QMINPSZ  = 3,   /* q_minpsz */
        QCOUNT   = 4,   /* q_count or qb_count */
        QFIRST   = 5,   /* q_first or qb_first */
        QLAST    = 6,   /* q_last or qb_last */
        QFLAG    = 7,   /* q_flag or qb_flag */
        QBAD     = 8
} qfields_t;
.ft
.fi
.RE
.IP "\f2pri\f1" 10n
Priority of request.
.IP "\f2valp\f1" 10n
The value for the requested field.
.RE
.SH DESCRIPTION
\f4strqget\f1 gives drivers and modules a way to get information
about a queue or a particular band of a queue without
directly accessing STREAMS data structures.
.SH RETURN VALUE
On success, \f40\f1 is returned.
An error number is returned on failure.
.SH LEVEL
Base or Interrupt
.SH SEE ALSO
\f2BCI Driver Development Guide\f1, Chapter 7, ``STREAMS''
.P
.na
\f4strqset\f1(D3DK)
.ad
