Kernel Functions for Drivers                 csxGetTupleData(9F)



NAME
     csxGetTupleData - return the data portion of a tuple

SYNOPSIS
     #include 



     int32t csxGetTupleData(clienthandlet ch, tuplet *tu);


INTERFACE LEVEL
     Solaris DI Specific (Solaris DI)

PARAMETERS
     ch    Client handle returned from csxRegisterClient(9F).


     tu    Pointer to a tuplet structure.


DESCRIPTION
     This function returns  the  data  portion  of  a  tuple,  as
     returned      by      the      csxGetFirstTuple(9F)     and
     csxGetNextTuple(9F) functions.

STRUCTURE MEMBERS
     The structure members of tuplet are:


     The fields are defined as follows:

       uint32t  Socket;                           /* socket number */
       uint32t  Attributes;                       /* tuple attributes*/
       cisdatat DesiredTuple;                     /* tuple to search for*/
       cisdatat TupleOffset;                      /* tuple data offset*/
       cisdatat TupleDataMax;                     /* max tuple data size*/
       cisdatat TupleDataLen;                     /* actual tuple data length*/
       cisdatat TupleData[CISMAXTUPLEDATALEN];/* tuple body data buffer*/
       cisdatat TupleCode;                        /* tuple type code*/
       cisdatat TupleLink;                        /* tuple link */


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


     Attributes      Initialized  by   csxGetFirstTuple(9F)   or
                     csxGetNextTuple(9F);  the  client  must not
                     modify the value in this field.




SunOS 5.11          Last change: 20 Dec 1996                    1






Kernel Functions for Drivers                 csxGetTupleData(9F)



     DesiredTuple    Initialized  by   csxGetFirstTuple(9F)   or
                     csxGetNextTuple(9F);  the  client  must not
                     modify the value in this field.


     TupleOffset     This field allows partial tuple  information
                     to  be  retrieved,  starting anywhere within
                     the tuple.


     TupleDataMax    This field is the size  of  the  tuple  data
                     buffer that Card Services uses to return raw
                     tuple data from csxGetTupleData. It can  be
                     larger than the number of bytes in the tuple
                     data body. Card Services ignores  any  value
                     placed here by the client.


     TupleDataLen    This field is the actual size of  the  tuple
                     data body. It represents the number of tuple
                     data body bytes returned.


     TupleData       This field is an array of  bytes  containing
                     the raw tuple data body contents.


     TupleCode       Initialized  by   csxGetFirstTuple(9F)   or
                     csxGetNextTuple(9F);  the  client  must not
                     modify the value in this field.


     TupleLink       Initialized  by   csxGetFirstTuple(9F)   or
                     csxGetNextTuple(9F);  the  client  must not
                     modify the value in this field.


RETURN VALUES
     CSUCES                 Successful operation.


     CSBADHANDLE              Client handle is invalid.


     CSBADARGS                Data          from          prior
                                csxGetFirstTuple(9F)          or
                                csxGetNextTuple(9F) is corrupt.


     CSNOCARD                 No PC Card in socket.





SunOS 5.11          Last change: 20 Dec 1996                    2






Kernel Functions for Drivers                 csxGetTupleData(9F)



     CSNOCIS                  No  Card  Information   Structure
                                (CIS) on PC Card.


     CSNOMOREITEMS           Card Services  was  not  able  to
                                read the tuple from the PC Card.


     CSUNSUPORTEDFUNCTION    No PCMCIA hardware installed.


CONTEXT
     This function may be called from user or kernel context.

SEE ALSO
     csxGetFirstTuple(9F),                   csxParseTuple(9F),
     csxRegisterClient(9F), csxValidateCIS(9F), tuple(9S)


     PC Card 95 Standard, PCMCIA/JEIDA



































SunOS 5.11          Last change: 20 Dec 1996                    3