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

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

May 16, 1997 CSX_GETFIRSTCLIENT(9F)