opensolaris man page for csx_getfirstclient

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.11							    16 May 1997 					    csx_GetFirstClient(9F)