2.2.2.19 Transmit_Call

The Transmit_Call structure is used to send data to the smart card associated with a valid context.

 typedef struct _Transmit_Call {
   REDIR_SCARDHANDLE hCard;
   SCardIO_Request ioSendPci;
   [range(0,66560)] unsigned long cbSendLength;
   [size_is(cbSendLength)] const byte* pbSendBuffer;
   [unique] SCardIO_Request* pioRecvPci;
   long fpbRecvBufferIsNULL;
   unsigned long cbRecvLength;
 } Transmit_Call;

hCard: A handle, as specified in section 2.2.1.2.

ioSendPci: A packet specifying input header information as specified in section 2.2.1.8.

cbSendLength: The length, in bytes, of the pbSendBuffer field.

pbSendBuffer: The data to be written to the card. The format of the data is specific to an individual card. For more information about data formats, see [ISO/IEC-7816-4] sections 5 through 7.

pioRecvPci: If non-NULL, this field is an SCardIO_Request packet that is set up in the same way as the ioSendPci field and passed as the pioRecvPci parameter of the Transmit call. If the value of this is NULL, the caller is not requesting the pioRecvPci value to be returned.

fpbRecvBufferIsNULL: A Boolean value specifying whether the caller wants to retrieve the length of the data. MUST be set to TRUE (0x00000001) if the caller wants only to retrieve the length of the data; otherwise, it MUST be set to FALSE (0x00000000).

Name

Value

FALSE

0x00000000

TRUE

0x00000001

cbRecvLength: The maximum size of the buffer to be returned. MUST be ignored if fpbRecvBufferIsNULL is set to TRUE (0x00000001).