csx_GetFirstClient(9F)					   Kernel Functions for Drivers 				    csx_GetFirstClient(9F)

NAME

       csx_GetFirstClient, csx_GetNextClient - return first or next client

SYNOPSIS

       #include <sys/pccard.h>

       int32_t csx_GetFirstClient(get_firstnext_client_t *fnc);

       int32_t csx_GetNextClient(get_firstnext_client_t *fnc);

INTERFACE LEVEL

       Solaris DDI Specific (Solaris DDI)

PARAMETERS

       fnc	Pointer to a get_firstnext_client_t structure.

DESCRIPTION

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

STRUCTURE MEMBERS

       The structure members of get_firstnext_client_t are:

       uint32_t 	 Socket;	  /* socket number */
       uint32_t 	 Attributes;	  /* attributes */
       client_handle_t	 client_handle;   /* client handle */
       uint32_t 	 num_clients;	  /* number of clients */

       The fields are defined as follows:

       Socket	       If the CS_GET_FIRSTNEXT_CLIENT_SOCKET_ONLY attribute is set, return information only on the   PC  card  installed  in  this
		       socket.

       Attributes      This field indicates the type of client. The field is bit-mapped; the following bits are defined:

		       CS_GET_FIRSTNEXT_CLIENT_ALL_CLIENTS

			   Return information on all clients.

		       CS_GET_FIRSTNEXT_CLIENT_SOCKET_ONLY

			   Return client information for the specified socket only.

       client_handle   The client handle of the PC card driver is returned in this field.

       num_clients     The number of clients is returned in this field.

RETURN VALUES

       CS_SUCCESS		       Successful operation.

       CS_BAD_HANDLE		       Client handle is invalid.

       CS_BAD_SOCKET		       Socket number is invalid.

       CS_NO_CARD		       No PC Card in socket.

       CS_NO_MORE_ITEMS 	       PC Card driver does not handle the CS_EVENT_CLIENT_INFO event.

       CS_UNSUPPORTED_FUNCTION	       No PCMCIA hardware installed.

CONTEXT

       This function may be called from user or kernel context.

SEE ALSO

       csx_event_handler(9E)

       PC Card 95 Standard, PCMCIA/JEIDA

SunOS 5.10							    16 May 1997 					    csx_GetFirstClient(9F)