csx_Parse_CISTPL_SPCL - parse the Special Purpose tuple
#include <sys/pccard.h>
int32_t csx_Parse_CISTPL_SPCL(client_handle_t ch, tuple_t *tu,
cistpl_spcl_t *csp);
Solaris DDI Specific (Solaris DDI)
Client handle returned from csx_RegisterClient(9F).
Pointer to a tuple_t structure (see tuple(9S)) returned by a call to csx_GetFirstTuple(9F) or csx_GetNextTuple(9F).
Pointer to a cistpl_spcl_t structure which contains the parsed CISTPL_SPCL tuple information upon return from this function.
This function parses the Special Purpose tuple, CISTPL_SPCL, into a form usable by PC Card drivers.
The CISTPL_SPCL tuple is identified by an identification field that is assigned by PCMCIA or JEIDA. A sequence field allows a series of CISTPL_SPCL tuples to be used when the data exceeds the size that can be stored in a single tuple; the maximum data area of a series of CISTPL_SPCL tuples is unlimited. Another field gives the number of bytes in the data field in this tuple.
The structure members of cistpl_date_t are:
uint32_t id; /* tuple contents identification */ uint32_t seq; /* data sequence number */ uint32_t bytes; /* number of bytes following */ uchar_t data[CIS_MAX_TUPLE_DATA_LEN];
The fields are defined as follows:
This field contains a PCMCIA or JEIDA assigned value that identifies this series of one or more CISTPL_SPCL tuples. These field values are assigned by contacting either PCMCIA or JEIDA.
This field contains a data sequence number. CISTPL_SPCL_SEQ_END is the last tuple in sequence.
This field contains the number of data bytes in the data[CIS_MAX_TUPLE_DATA_LEN].
The data component of this tuple.
Successful operation.
Client handle is invalid.
Parser does not know how to parse tuple.
No PC Card in socket.
No Card Information Structure (CIS) on PC Card.
No PCMCIA hardware installed.
This function may be called from user or kernel context.
csx_GetFirstTuple(9F), csx_GetTupleData(9F), csx_RegisterClient(9F), csx_ValidateCIS(9F), tuple(9S)
PC Card 95 Standard, PCMCIA/JEIDA