Microsoft Windows CE 3.0  

IOCTL_SMARTCARD_TRANSMIT

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This code transmits data to and from the currently inserted smart card.

Parameters

dwOpenData
Handle returned from a call to the smart card reader driver's XXX_Openfunction.
dwCode
Specifies this code.
pBufIn
A pointer to an SCARD_IO_REQUESTstructure followed by the data to be transmitted. An SCARD_IO_REQUESTstructure has the following definition:
typedef struct _SCARD_IO_REQUEST{ DWORD
dwProtocol; // Protocol identifier DWORD cbPciLength; // Protocol
Control Information Length } SCARD_IO_REQUEST, *PSCARD_IO_REQUEST,
*LPSCARD_IO_REQUEST;
dwLenIn
The size of the SCARD_IO_REQUESTstructure plus the size of the data to be transmitted.
pBufOut
Receives data transmitted from the smart card. This buffer consists of an SCARD_IO_REQUEST structure followed by the transmitted data.
dwLenOut
The size of the SCARD_IO_REQUESTstructure plus the size of the data transmitted from the smart card.
pdwActualOut
Ignored.

Return Values

One of the following status values:

Status Meaning
STATUS_SUCCESS The transmission was successful.
STATUS_NO_MEDIA There is no card in reader.
STATUS_IO_TIMEOUT The operation timed out.
STATUS_INVALID_DEVICE_STATE The protocol in the header does not match the previously selected card protocol.

Remarks

The member dwProtocolmust be set to the previously selected protocol, and cbPciLengthmust be set to the size of the SCARD_IO_REQUESTstructure itself (usually eight). The input buffer and the output buffer pointers can point to to the same memory area; it is the smart card reader driver's responsibility to avoid overwriting the input data. Use the Smart Card Driver Library to ensure that the input data is not overwritten.



 Last updated on Tuesday, July 13, 2004

© 2004 Microsoft Corporation. All rights reserved.