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

July 19, 1996 CSX_VALIDATECIS(9F)