CARD_TUPLE_PARMS

This structure contains tuple information passed to the CardGetFirstTuple, CardGetNextTuple, and CardGetTupleData functions.

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

Handle to a socket and function pair.

fAttributes

[IN] Specifies TUPLE_RETURN_LINKS to return link tuples. The first bit is one.

uDesiredTuple

[IN] Specifies the desired tuple code. If it is 0xFF, the first tuple encountered is returned.

uReserved

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

fFlags

[IN/OUT] Specifies flags used internally by Card Services. A driver must maintain this value between calls to tuple functions.

uLinkOffset

[IN/OUT] Specifies a tuple link offset used internally by Card Services. A driver must maintain this value between calls to tuple functions.

uCISOffset

[IN/OUT] Specifies CIS state information used internally by Card Services. A driver must maintain this value between calls to tuple functions.

uTupleCode

[OUT] Specifies the type of tuple found.

uTupleLink

[OUT] Specifies a link value for tuple found.

Remarks

A 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