csx_Parse_CISTPL_VERS_1(9f)

1csx_Parse_CISTPL_VERS_1(9FK)ernel Functions for Drivercssx_Parse_CISTPL_VERS_1(9F)
2
3
4

NAME

6       csx_Parse_CISTPL_VERS_1  -  parse  Level-1  Version/Product Information
7       tuple
8

SYNOPSIS

10       #include <sys/pccard.h>
11
12
13
14       int32_t csx_Parse_CISTPL_VERS_1(client_handle_t ch, tuple_t *tu,
15            cistpl_vers_1_t *cv1);
16
17

INTERFACE LEVEL

19       Solaris DDI Specific (Solaris DDI)
20

PARAMETERS

22       ch     Client handle returned from csx_RegisterClient(9F).
23
24
25       tu     Pointer to a tuple_t structure (see  tuple(9S))  returned  by  a
26              call to csx_GetFirstTuple(9F) or csx_GetNextTuple(9F).
27
28
29       cv1    Pointer to a cistpl_vers_1_t structure which contains the parsed
30              CISTPL_VERS_1 tuple information upon return from this function.
31
32

DESCRIPTION

34       This function parses the  Level-1  Version/Product  Information  tuple,
35       CISTPL_VERS_1, into a form usable by PC Card drivers.
36
37
38       The  CISTPL_VERS_1  tuple  is used to describe the card Level-1 version
39       compliance and card manufacturer information.
40

STRUCTURE MEMBERS

42       The structure members of cistpl_vers_1_t are:
43
44         uint32_t   major;  /* major version number */
45         uint32_t   minor;  /* minor version number */
46         uint32_t   ns;     /* number of information strings */
47         char       pi[CISTPL_VERS_1_MAX_PROD_STRINGS]
48                        [CIS_MAX_TUPLE_DATA_LEN];
49                            /* pointers to product information strings */
50
51

RETURN VALUES

53       CS_SUCCESS                 Successful operation.
54
55
56       CS_BAD_HANDLE              Client handle is invalid.
57
58
59       CS_UNKNOWN_TUPLE           Parser does not know how to parse tuple.
60
61
62       CS_NO_CARD                 No PC Card in socket.
63
64
65       CS_NO_CIS                  No Card Information Structure  (CIS)  on  PC
66                                  Card.
67
68
69       CS_UNSUPPORTED_FUNCTION    No PCMCIA hardware installed.
70
71

CONTEXT

73       This function may be called from user or kernel context.
74