csx_ValidateCIS(9f)

1csx_ValidateCIS(9F)      Kernel Functions for Drivers      csx_ValidateCIS(9F)
2
3
4

NAME

6       csx_ValidateCIS - validate the Card Information Structure (CIS)
7

SYNOPSIS

9       #include <sys/pccard.h>
10
11
12
13       int32_t csx_ValidateCIS(client_handle_t ch, cisinfo_t *ci);
14
15

INTERFACE LEVEL

17       Solaris DDI Specific (Solaris DDI)
18

PARAMETERS

20       ch    Client handle returned from csx_RegisterClient(9F).
21
22
23       ci    Pointer to a cisinfo_t structure.
24
25

DESCRIPTION

27       This  function validates the Card Information Structure (CIS) on the PC
28       Card in the specified socket.
29

STRUCTURE MEMBERS

31       The structure members of cisinfo_t are:
32
33          uint32_t     Socket;    /* socket number to validate CIS on */
34           uint32_t     Chains;    /* number of tuple chains in CIS */
35           uint32_t     Tuples;    /* total number of tuples in CIS */
36
37
38
39       The fields are defined as follows:
40
41       Socket    Not used in Solaris, but for portability with other Card Ser‐
42                 vices implementations, it should be set to the logical socket
43                 number.
44
45
46       Chains    This field returns the number of valid tuple  chains  located
47                 in the CIS. If 0 is returned, the CIS is not valid.
48
49
50       Tuples    This field is a Solaris-specific extension and it returns the
51                 total number of tuples on all the chains  in  the  PC  Card's
52                 CIS.
53
54

RETURN VALUES

56       CS_SUCCESS                 Successful operation.
57
58
59       CS_NO_CIS                  No CIS on PC Card or CIS is invalid.
60
61
62       CS_NO_CARD                 No PC Card in socket.
63
64
65       CS_UNSUPPORTED_FUNCTION    No PCMCIA hardware installed.
66
67

CONTEXT

69       This function may be called from user or kernel context.
70