PTEID_CardInterfaceCallbacks Struct Reference

Public Attributes
void *	context
PTEID_EstablishContextFn	establishContext
PTEID_ReleaseContextFn	releaseContext
PTEID_ListReadersFn	listReaders
PTEID_CardPresentInReaderFn	cardPresentInReader
PTEID_StatusWithATRFn	statusWithATR
PTEID_ConnectFn	connect
PTEID_DisconnectFn	disconnect
PTEID_TransmitFn	transmit
PTEID_RecoverFn	recover
PTEID_ControlFn	control
PTEID_BeginTransactionFn	beginTransaction
PTEID_EndTransactionFn	endTransaction

Member Data Documentation

beginTransaction

PTEID_BeginTransactionFn PTEID_CardInterfaceCallbacks::beginTransaction

Function to begin a transaction

Parameters

handle	Card handle
context	Pointer to the context

cardPresentInReader

PTEID_CardPresentInReaderFn PTEID_CardInterfaceCallbacks::cardPresentInReader

Function to check whether there is a card present in the given reader. Must not wait for card.

Parameters

csReader	Name of the reader
context	Pointer to the context

Returns

OK if card is present

connect

PTEID_ConnectFn PTEID_CardInterfaceCallbacks::connect

Function to connect to a card

Parameters

csReader	Name of the reader
outHandle	Pointer to receive card handle
outProtocol	Pointer to receive protocol used by the card
context	Pointer to the context

Returns

OK if success

context

void* PTEID_CardInterfaceCallbacks::context

Pointer to the user-defined context

control

PTEID_ControlFn PTEID_CardInterfaceCallbacks::control

Function to use a reader-specific function specified through control code

Parameters

handle	Card handle
ulControl	Control code
cmdData	Command data
cmdLength	Length of command data
respBuffer	Buffer to receive response
respBufferSize	Pointer to the size of the response buffer
ulMaxResponseSize	Maximum response size
context	Pointer to the context

disconnect

PTEID_DisconnectFn PTEID_CardInterfaceCallbacks::disconnect

Function to disconnect from a card

Parameters

handle	Card handle
context	Pointer to the context

endTransaction

PTEID_EndTransactionFn PTEID_CardInterfaceCallbacks::endTransaction

Function to end a transaction

Parameters

handle	Card handle
context	Pointer to the context

establishContext

PTEID_EstablishContextFn PTEID_CardInterfaceCallbacks::establishContext

Type definitions for PTEID Card Reader interface functions

Function to establish a context for card operations

Parameters

context

Pointer to the context

listReaders

PTEID_ListReadersFn PTEID_CardInterfaceCallbacks::listReaders

Function to list available card readers Reader names are listed as a multi-string structure. Card reader names are separated by a single 0x00 byte and the structure ends with 2 0x00 bytes.

Parameters

buffer	Pre-allocated buffer to fill with reader names
bufferSize	[in/out] On input: maximum buffer size, on output: actual bytes written
context	Pointer to the context

recover

PTEID_RecoverFn PTEID_CardInterfaceCallbacks::recover

Function to recover a card connection

Parameters

handle	Card handle
pulLockCount	Pointer to receive lock count
context	Pointer to the context

releaseContext

PTEID_ReleaseContextFn PTEID_CardInterfaceCallbacks::releaseContext

Function to release a previously established context

Parameters

context

Pointer to the context

statusWithATR

PTEID_StatusWithATRFn PTEID_CardInterfaceCallbacks::statusWithATR

Function to get reader status with ATR

Parameters

handle	Card handle
buffer	Buffer to receive ATR
bufferSize	Pointer to the size of the buffer
context	Pointer to the context

Returns

OK if success

transmit

PTEID_TransmitFn PTEID_CardInterfaceCallbacks::transmit

Function to transmit data to a card

Parameters

handle	Card handle
cmdData	Command data
cmdLength	Length of command data
responseBuffer	Buffer to receive response
respBufferSize	Pointer to the size of the response buffer
plRetVal	Pointer to receive return value
pSendPci	Send protocol control information
pRecvPci	Receive protocol control information
context	Pointer to the context