CARD_TUPLE_PARMS

The CARD_TUPLE_PARMS structure contains tuple information passed to CardGetFirstTuple, CardGetNextTuple, and CardGetTupleData.

Syntax

typedef struct {
CARD_SOCKET_HANDLE hSocket;
UINT16 fAttributes;
UINT8 uDesiredTuple;
UINT8 uReserved;
UINT16 fFlags;
UINT32 uLinkOffset;
UINT32 uCISOffset;
UINT8 uTupleCode;
UINT8 uTupleLink;
} CARD_TUPLE_PARMS, *PCARD_TUPLE_PARMS;

Members

hSocket

Specifies a handle to a socket and function pair.

fAttributes

Specify TUPLE_RETURN_LINKS (first bit is one) to return link tuples. (Input)

uDesiredTuple

Specifies the desired tuple code. If 0xFF, then the first tuple encountered is returned. See PC Card Tuple Codes. (Input)

uReserved

Reserved for internal use only to maintain alignment with the CARD_DATA_PARMS structure.

fFlags

Specifies flags used internally by Card Services. A driver must maintain this value between calls to tuple functions. (Input/Output)

uLinkOffset

Specifies a tuple link offset used internally by Card Services. A driver must maintain this value between calls to tuple functions. (Input/Output)

uCISOffset

Specifies CIS state information used internally by Card Services. A driver must maintain this value between calls to tuple functions. (Input/Output)

uTupleCode

Specifies the type of tuple found. (Output)

uTupleLink

Specifies a link value for tuple found. (Output)

Remarks

Your driver should maintain the values for the hSocket, fFlags, uLinkOffset and uCISOffset members after using CardGetFirstTuple and between calls to CardGetNextTuple. Card Services requires these members to resume the tuple search.

See Also

CARD_DATA_PARMS, CardGetFirstTuple, CardGetNextTuple, CardGetTupleData