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.