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


NAME


csx_ValidateCIS - validate the Card Information Structure (CIS)

SYNOPSIS


#include <sys/pccard.h>


int32_t csx_ValidateCIS(client_handle_t ch, cisinfo_t *ci);


INTERFACE LEVEL


illumos DDI Specific (illumos DDI)

PARAMETERS


ch
Client handle returned from csx_RegisterClient(9F).


ci
Pointer to a cisinfo_t structure.


DESCRIPTION


This function validates the Card Information Structure (CIS) on the PC
Card in the specified socket.

STRUCTURE MEMBERS


The structure members of cisinfo_t are:

uint32_t Socket; /* socket number to validate CIS on */
uint32_t Chains; /* number of tuple chains in CIS */
uint32_t Tuples; /* total number of tuples in CIS */


The fields are defined as follows:

Socket
Not used in illumos, but for portability with other Card
Services implementations, it should be set to the logical
socket number.


Chains
This field returns the number of valid tuple chains located in
the CIS. If 0 is returned, the CIS is not valid.


Tuples
This field is an illumos-specific extension and it returns the
total number of tuples on all the chains in the PC Card's CIS.


RETURN VALUES


CS_SUCCESS
Successful operation.


CS_NO_CIS
No CIS on PC Card or CIS is invalid.


CS_NO_CARD
No PC Card in socket.


CS_UNSUPPORTED_FUNCTION
No PCMCIA hardware installed.


CONTEXT


This function may be called from user or kernel context.

SEE ALSO


csx_GetFirstTuple(9F), csx_GetTupleData(9F), csx_ParseTuple(9F),
csx_RegisterClient(9F)


PC Card 95 Standard, PCMCIA/JEIDA


illumos July 19, 1996 CSX_VALIDATECIS(9F)