csx_GetFirstClient(9f)

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

NAME

6       csx_GetFirstClient, csx_GetNextClient - return first or next client
7

SYNOPSIS

9       #include <sys/pccard.h>
10
11
12
13       int32_t csx_GetFirstClient(get_firstnext_client_t *fnc);
14
15
16       int32_t csx_GetNextClient(get_firstnext_client_t *fnc);
17
18

INTERFACE LEVEL

20       Solaris DDI Specific (Solaris DDI)
21

PARAMETERS

23       fnc     Pointer to a get_firstnext_client_t structure.
24
25

DESCRIPTION

27       The   functions  csx_GetFirstClient()  and  csx_GetNextClient()  return
28       information about the first or subsequent PC cards, respectively,  that
29       are installed in the system.
30

STRUCTURE MEMBERS

32       The structure members of get_firstnext_client_t are:
33
34         uint32_t          Socket;          /* socket number */
35         uint32_t          Attributes;      /* attributes */
36         client_handle_t   client_handle;   /* client handle */
37         uint32_t          num_clients;     /* number of clients */
38
39
40
41       The fields are defined as follows:
42
43       Socket            If  the CS_GET_FIRSTNEXT_CLIENT_SOCKET_ONLY attribute
44                         is set, return  information  only  on  the   PC  card
45                         installed in this socket.
46
47
48       Attributes        This field indicates the type of client. The field is
49                         bit-mapped; the following bits are defined:
50
51                         CS_GET_FIRSTNEXT_CLIENT_ALL_CLIENTS
52
53                             Return information on all clients.
54
55
56                         CS_GET_FIRSTNEXT_CLIENT_SOCKET_ONLY
57
58                             Return  client  information  for  the   specified
59                             socket only.
60
61
62
63       client_handle     The  client  handle of the PC card driver is returned
64                         in this field.
65
66
67       num_clients       The number of clients is returned in this field.
68
69

RETURN VALUES

71       CS_SUCCESS                  Successful operation.
72
73
74       CS_BAD_HANDLE               Client handle is invalid.
75
76
77       CS_BAD_SOCKET               Socket number is invalid.
78
79
80       CS_NO_CARD                  No PC Card in socket.
81
82
83       CS_NO_MORE_ITEMS            PC  Card  driver  does   not   handle   the
84                                   CS_EVENT_CLIENT_INFO event.
85
86
87       CS_UNSUPPORTED_FUNCTION     No PCMCIA hardware installed.
88
89

CONTEXT

91       This function may be called from user or kernel context.
92