te
 Copyright (c) 1997, Sun Microsystems, Inc. All Rights Reserved
 The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
 You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
 When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
 CSX_GETFIRSTCLIENT 9F "May 16, 1997"
 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
illumos DDI Specific (illumos 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