Sophie

Sophie

distrib > Fedora > 15 > i386 > by-pkgid > 1d49b8f9ae104bfd1869bc35e6bbf50d > files > 134

pcsc-lite-doc-1.7.2-1.fc15.noarch.rpm

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>pcsc-lite: ifdwrapper.c Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.3 -->
<div id="top">
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  <td style="padding-left: 0.5em;">
   <div id="projectname">pcsc-lite&#160;<span id="projectnumber">1.7.2</span></div>
  </td>
 </tr>
 </tbody>
</table>
</div>
  <div id="navrow1" class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&#160;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&#160;Structures</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
      <li><a href="dirs.html"><span>Directories</span></a></li>
    </ul>
  </div>
  <div id="navrow2" class="tabs2">
    <ul class="tablist">
      <li><a href="files.html"><span>File&#160;List</span></a></li>
      <li><a href="globals.html"><span>Globals</span></a></li>
    </ul>
  </div>
  <div id="nav-path" class="navpath">
    <ul>
      <li class="navelem"><a class="el" href="dir_7a4553ee0c3b13d0e595a5d1659110a6.html">src</a>      </li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="headertitle">
<h1>ifdwrapper.c</h1>  </div>
</div>
<div class="contents">
<a href="ifdwrapper_8c.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
<a name="l00002"></a>00002 <span class="comment"> * MUSCLE SmartCard Development ( http://www.linuxnet.com )</span>
<a name="l00003"></a>00003 <span class="comment"> *</span>
<a name="l00004"></a>00004 <span class="comment"> * Copyright (C) 1999-2004</span>
<a name="l00005"></a>00005 <span class="comment"> *  David Corcoran &lt;corcoran@linuxnet.com&gt;</span>
<a name="l00006"></a>00006 <span class="comment"> * Copyright (C) 2003-2004</span>
<a name="l00007"></a>00007 <span class="comment"> *  Damien Sauveron &lt;damien.sauveron@labri.fr&gt;</span>
<a name="l00008"></a>00008 <span class="comment"> * Copyright (C) 2002-2010</span>
<a name="l00009"></a>00009 <span class="comment"> *  Ludovic Rousseau &lt;ludovic.rousseau@free.fr&gt;</span>
<a name="l00010"></a>00010 <span class="comment"> *</span>
<a name="l00011"></a>00011 <span class="comment"> * $Id: ifdwrapper.c 5567 2011-01-29 13:18:49Z rousseau $</span>
<a name="l00012"></a>00012 <span class="comment"> */</span>
<a name="l00013"></a>00013 
<a name="l00019"></a>00019 <span class="preprocessor">#include &lt;errno.h&gt;</span>
<a name="l00020"></a>00020 <span class="preprocessor">#include &lt;unistd.h&gt;</span>
<a name="l00021"></a>00021 <span class="preprocessor">#include &lt;pthread.h&gt;</span>
<a name="l00022"></a>00022 
<a name="l00023"></a>00023 <span class="preprocessor">#include &quot;config.h&quot;</span>
<a name="l00024"></a>00024 <span class="preprocessor">#include &quot;misc.h&quot;</span>
<a name="l00025"></a>00025 <span class="preprocessor">#include &quot;<a class="code" href="pcscd_8h.html" title="This keeps a list of defines for pcsc-lite.">pcscd.h</a>&quot;</span>
<a name="l00026"></a>00026 <span class="preprocessor">#include &quot;debuglog.h&quot;</span>
<a name="l00027"></a>00027 <span class="preprocessor">#include &quot;<a class="code" href="readerfactory_8h.html" title="This keeps track of a list of currently available reader structures.">readerfactory.h</a>&quot;</span>
<a name="l00028"></a>00028 <span class="preprocessor">#include &quot;<a class="code" href="ifdwrapper_8h.html" title="This wraps the dynamic ifdhandler functions.">ifdwrapper.h</a>&quot;</span>
<a name="l00029"></a>00029 <span class="preprocessor">#include &quot;<a class="code" href="atrhandler_8h.html" title="This keeps track of smartcard protocols, timing issues and Answer to Reset ATR handling.">atrhandler.h</a>&quot;</span>
<a name="l00030"></a>00030 <span class="preprocessor">#include &quot;<a class="code" href="dyn__generic_8h.html" title="This abstracts dynamic library loading functions.">dyn_generic.h</a>&quot;</span>
<a name="l00031"></a>00031 <span class="preprocessor">#include &quot;<a class="code" href="sys__generic_8h.html" title="This handles abstract system level calls.">sys_generic.h</a>&quot;</span>
<a name="l00032"></a>00032 <span class="preprocessor">#include &quot;utils.h&quot;</span>
<a name="l00033"></a>00033 
<a name="l00034"></a>00034 <span class="preprocessor">#ifdef PCSCLITE_STATIC_DRIVER</span>
<a name="l00035"></a>00035 <span class="preprocessor"></span><span class="comment">/* check that either IFDHANDLERv2 or IFDHANDLERv3 is</span>
<a name="l00036"></a>00036 <span class="comment"> * defined */</span>
<a name="l00037"></a>00037 <span class="preprocessor">  #if ! (defined(IFDHANDLERv2) || defined(IFDHANDLERv3))</span>
<a name="l00038"></a>00038 <span class="preprocessor"></span><span class="preprocessor">  #error IFDHANDLER version not defined</span>
<a name="l00039"></a>00039 <span class="preprocessor"></span><span class="preprocessor">  #endif</span>
<a name="l00040"></a>00040 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
<a name="l00041"></a>00041 <span class="preprocessor"></span>
<a name="l00046"></a><a class="code" href="ifdwrapper_8h.html#a10cc572b8167d4ca055b7e9fe55db036">00046</a> LONG <a class="code" href="ifdwrapper_8c.html#ad794bea544918757cd2fbbae218fa458" title="Set the protocol type selection (PTS).">IFDSetPTS</a>(<a class="code" href="structReaderContext.html">READER_CONTEXT</a> * rContext, DWORD dwProtocol, UCHAR ucFlags,
<a name="l00047"></a>00047     UCHAR ucPTS1, UCHAR ucPTS2, UCHAR ucPTS3)
<a name="l00048"></a>00048 {
<a name="l00049"></a>00049     RESPONSECODE rv = <a class="code" href="ifdhandler_8h.html#ae45ef2a236e5e6f15eb6b24a7bdf2d72" title="no error">IFD_SUCCESS</a>;
<a name="l00050"></a>00050     UCHAR ucValue[1];
<a name="l00051"></a>00051 
<a name="l00052"></a>00052 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00053"></a>00053 <span class="preprocessor"></span>    RESPONSECODE(*IFDH_set_protocol_parameters) (DWORD, DWORD, UCHAR,
<a name="l00054"></a>00054         UCHAR, UCHAR, UCHAR) = NULL;
<a name="l00055"></a>00055 
<a name="l00056"></a>00056     IFDH_set_protocol_parameters = (RESPONSECODE(*)(DWORD, DWORD, UCHAR,
<a name="l00057"></a>00057         UCHAR, UCHAR, UCHAR))
<a name="l00058"></a>00058         rContext-&gt;<a class="code" href="structReaderContext.html#a627d54efaa512c2d1cc5d43367ee9420" title="driver functions">psFunctions</a>.<a class="code" href="structReaderContext.html#ab843b091726f4cb816f0f74c0318bc17" title="API V2.0.">psFunctions_v2</a>.pvfSetProtocolParameters;
<a name="l00059"></a>00059 
<a name="l00060"></a>00060     <span class="keywordflow">if</span> (NULL == IFDH_set_protocol_parameters)
<a name="l00061"></a>00061         <span class="keywordflow">return</span> <a class="code" href="pcsclite_8h.html#aef39984cd0dd3822088099fffd9d5f96" title="This smart card does not support the requested feature.">SCARD_E_UNSUPPORTED_FEATURE</a>;
<a name="l00062"></a>00062 <span class="preprocessor">#endif</span>
<a name="l00063"></a>00063 <span class="preprocessor"></span>
<a name="l00064"></a>00064     <span class="comment">/*</span>
<a name="l00065"></a>00065 <span class="comment">     * Locking is done in winscard.c SCardConnect() and SCardReconnect()</span>
<a name="l00066"></a>00066 <span class="comment">     *</span>
<a name="l00067"></a>00067 <span class="comment">     * This avoids to renegotiate the protocol and confuse the card</span>
<a name="l00068"></a>00068 <span class="comment">     * Error returned by CCID driver is: CCID_Receive Procedure byte conflict</span>
<a name="l00069"></a>00069 <span class="comment">     */</span>
<a name="l00070"></a>00070 
<a name="l00071"></a>00071     ucValue[0] = rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>;
<a name="l00072"></a>00072 
<a name="l00073"></a>00073 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00074"></a>00074 <span class="preprocessor"></span>    rv = (*IFDH_set_protocol_parameters) (rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>,
<a name="l00075"></a>00075         dwProtocol, ucFlags, ucPTS1, ucPTS2, ucPTS3);
<a name="l00076"></a>00076 <span class="preprocessor">#else</span>
<a name="l00077"></a>00077 <span class="preprocessor"></span>    rv = <a class="code" href="group__IFDHandler.html#gaa6fc195cb450a147550f4671492257ad" title="This function should set the Protocol Type Selection (PTS) of a particular card/slot using the three ...">IFDHSetProtocolParameters</a>(rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>, dwProtocol, ucFlags,
<a name="l00078"></a>00078         ucPTS1, ucPTS2, ucPTS3);
<a name="l00079"></a>00079 <span class="preprocessor">#endif</span>
<a name="l00080"></a>00080 <span class="preprocessor"></span>
<a name="l00081"></a>00081     <span class="keywordflow">return</span> rv;
<a name="l00082"></a>00082 }
<a name="l00083"></a>00083 
<a name="l00087"></a><a class="code" href="ifdwrapper_8h.html#ac836da4050827c80f72b893112c5b252">00087</a> LONG <a class="code" href="ifdwrapper_8c.html#aef3b5dc4b2d783af6edcc09a0102471c" title="Open a communication channel to the IFD.">IFDOpenIFD</a>(<a class="code" href="structReaderContext.html">READER_CONTEXT</a> * rContext)
<a name="l00088"></a>00088 {
<a name="l00089"></a>00089     RESPONSECODE rv = 0;
<a name="l00090"></a>00090 
<a name="l00091"></a>00091 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00092"></a>00092 <span class="preprocessor"></span>    RESPONSECODE(*IFDH_create_channel) (DWORD, DWORD) = NULL;
<a name="l00093"></a>00093     RESPONSECODE(*IFDH_create_channel_by_name) (DWORD, LPSTR) = NULL;
<a name="l00094"></a>00094 
<a name="l00095"></a>00095     <span class="keywordflow">if</span> (rContext-&gt;<a class="code" href="structReaderContext.html#aad880fc4455c253781e8968f2239d56f" title="IFD Handler version number.">version</a> == IFD_HVERSION_2_0)
<a name="l00096"></a>00096         IFDH_create_channel =
<a name="l00097"></a>00097             rContext-&gt;<a class="code" href="structReaderContext.html#a627d54efaa512c2d1cc5d43367ee9420" title="driver functions">psFunctions</a>.<a class="code" href="structReaderContext.html#ab843b091726f4cb816f0f74c0318bc17" title="API V2.0.">psFunctions_v2</a>.pvfCreateChannel;
<a name="l00098"></a>00098     <span class="keywordflow">else</span>
<a name="l00099"></a>00099     {
<a name="l00100"></a>00100         IFDH_create_channel =
<a name="l00101"></a>00101             rContext-&gt;<a class="code" href="structReaderContext.html#a627d54efaa512c2d1cc5d43367ee9420" title="driver functions">psFunctions</a>.<a class="code" href="structReaderContext.html#a2419b85252a2e83704c6c98222ccc37a" title="API V3.0.">psFunctions_v3</a>.pvfCreateChannel;
<a name="l00102"></a>00102         IFDH_create_channel_by_name =
<a name="l00103"></a>00103             rContext-&gt;<a class="code" href="structReaderContext.html#a627d54efaa512c2d1cc5d43367ee9420" title="driver functions">psFunctions</a>.<a class="code" href="structReaderContext.html#a2419b85252a2e83704c6c98222ccc37a" title="API V3.0.">psFunctions_v3</a>.pvfCreateChannelByName;
<a name="l00104"></a>00104     }
<a name="l00105"></a>00105 <span class="preprocessor">#endif</span>
<a name="l00106"></a>00106 <span class="preprocessor"></span>
<a name="l00107"></a>00107     <span class="comment">/* LOCK THIS CODE REGION */</span>
<a name="l00108"></a>00108     (void)pthread_mutex_lock(rContext-&gt;<a class="code" href="structReaderContext.html#a221ef594a986ccfa18dfafb5d7954bc1" title="Mutex for this connection.">mMutex</a>);
<a name="l00109"></a>00109 
<a name="l00110"></a>00110 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00111"></a>00111 <span class="preprocessor"></span>    <span class="keywordflow">if</span> (rContext-&gt;<a class="code" href="structReaderContext.html#aad880fc4455c253781e8968f2239d56f" title="IFD Handler version number.">version</a> == IFD_HVERSION_2_0)
<a name="l00112"></a>00112     {
<a name="l00113"></a>00113         rv = (*IFDH_create_channel) (rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>, rContext-&gt;<a class="code" href="structReaderContext.html#a63c89c04d1feae07ca35558055155ffb" title="Port ID.">port</a>);
<a name="l00114"></a>00114     } <span class="keywordflow">else</span>
<a name="l00115"></a>00115     {
<a name="l00116"></a>00116         <span class="comment">/* use device name only if defined */</span>
<a name="l00117"></a>00117         <span class="keywordflow">if</span> (rContext-&gt;<a class="code" href="structReaderContext.html#af2ff1e3088c734549b4c3676c5e86a22" title="Device Name.">device</a>[0] != <span class="charliteral">&#39;\0&#39;</span>)
<a name="l00118"></a>00118             rv = (*IFDH_create_channel_by_name) (rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>, rContext-&gt;<a class="code" href="structReaderContext.html#af2ff1e3088c734549b4c3676c5e86a22" title="Device Name.">device</a>);
<a name="l00119"></a>00119         <span class="keywordflow">else</span>
<a name="l00120"></a>00120             rv = (*IFDH_create_channel) (rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>, rContext-&gt;<a class="code" href="structReaderContext.html#a63c89c04d1feae07ca35558055155ffb" title="Port ID.">port</a>);
<a name="l00121"></a>00121     }
<a name="l00122"></a>00122 <span class="preprocessor">#else</span>
<a name="l00123"></a>00123 <span class="preprocessor"></span><span class="preprocessor">#if defined(IFDHANDLERv2)</span>
<a name="l00124"></a>00124 <span class="preprocessor"></span>    rv = <a class="code" href="group__IFDHandler.html#gaccb95bc0b2e679c992c6928b0e0e3fe3" title="This function is required to open a communications channel to the port listed by Channel.">IFDHCreateChannel</a>(rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>, rContext-&gt;<a class="code" href="structReaderContext.html#a63c89c04d1feae07ca35558055155ffb" title="Port ID.">port</a>);
<a name="l00125"></a>00125 <span class="preprocessor">#else</span>
<a name="l00126"></a>00126 <span class="preprocessor"></span>    {
<a name="l00127"></a>00127         <span class="comment">/* Use device name only if defined */</span>
<a name="l00128"></a>00128         <span class="keywordflow">if</span> (rContext-&gt;lpcDevice[0] != <span class="charliteral">&#39;\0&#39;</span>)
<a name="l00129"></a>00129             rv = <a class="code" href="group__IFDHandler.html#gabb9fe35a68fa080ce9397f0b830b1e7e" title="This function is required to open a communications channel to the port listed by DeviceName.">IFDHCreateChannelByName</a>(rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>, rContext-&gt;lpcDevice);
<a name="l00130"></a>00130         <span class="keywordflow">else</span>
<a name="l00131"></a>00131             rv = <a class="code" href="group__IFDHandler.html#gaccb95bc0b2e679c992c6928b0e0e3fe3" title="This function is required to open a communications channel to the port listed by Channel.">IFDHCreateChannel</a>(rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>, rContext-&gt;<a class="code" href="structReaderContext.html#a63c89c04d1feae07ca35558055155ffb" title="Port ID.">port</a>);
<a name="l00132"></a>00132     }
<a name="l00133"></a>00133 <span class="preprocessor">#endif</span>
<a name="l00134"></a>00134 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
<a name="l00135"></a>00135 <span class="preprocessor"></span>
<a name="l00136"></a>00136     <span class="comment">/* END OF LOCKED REGION */</span>
<a name="l00137"></a>00137     (void)pthread_mutex_unlock(rContext-&gt;<a class="code" href="structReaderContext.html#a221ef594a986ccfa18dfafb5d7954bc1" title="Mutex for this connection.">mMutex</a>);
<a name="l00138"></a>00138 
<a name="l00139"></a>00139     <span class="keywordflow">return</span> rv;
<a name="l00140"></a>00140 }
<a name="l00141"></a>00141 
<a name="l00145"></a><a class="code" href="ifdwrapper_8h.html#a763393e6538f76630b9c0d1e51d36024">00145</a> LONG <a class="code" href="ifdwrapper_8c.html#aedc5eca2b5c9409bc3577763ca98cc18" title="Close a communication channel to the IFD.">IFDCloseIFD</a>(<a class="code" href="structReaderContext.html">READER_CONTEXT</a> * rContext)
<a name="l00146"></a>00146 {
<a name="l00147"></a>00147     RESPONSECODE rv = <a class="code" href="ifdhandler_8h.html#ae45ef2a236e5e6f15eb6b24a7bdf2d72" title="no error">IFD_SUCCESS</a>;
<a name="l00148"></a>00148     <span class="keywordtype">int</span> repeat;
<a name="l00149"></a>00149 
<a name="l00150"></a>00150 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00151"></a>00151 <span class="preprocessor"></span>    RESPONSECODE(*IFDH_close_channel) (DWORD) = NULL;
<a name="l00152"></a>00152 
<a name="l00153"></a>00153     IFDH_close_channel = rContext-&gt;<a class="code" href="structReaderContext.html#a627d54efaa512c2d1cc5d43367ee9420" title="driver functions">psFunctions</a>.<a class="code" href="structReaderContext.html#ab843b091726f4cb816f0f74c0318bc17" title="API V2.0.">psFunctions_v2</a>.pvfCloseChannel;
<a name="l00154"></a>00154 <span class="preprocessor">#endif</span>
<a name="l00155"></a>00155 <span class="preprocessor"></span>
<a name="l00156"></a>00156     <span class="comment">/* TRY TO LOCK THIS CODE REGION */</span>
<a name="l00157"></a>00157     repeat = 5;
<a name="l00158"></a>00158 again:
<a name="l00159"></a>00159     rv = pthread_mutex_trylock(rContext-&gt;<a class="code" href="structReaderContext.html#a221ef594a986ccfa18dfafb5d7954bc1" title="Mutex for this connection.">mMutex</a>);
<a name="l00160"></a>00160     <span class="keywordflow">if</span> (EBUSY == rv)
<a name="l00161"></a>00161     {
<a name="l00162"></a>00162         Log1(PCSC_LOG_ERROR, <span class="stringliteral">&quot;Locking failed&quot;</span>);
<a name="l00163"></a>00163         repeat--;
<a name="l00164"></a>00164         <span class="keywordflow">if</span> (repeat)
<a name="l00165"></a>00165         {
<a name="l00166"></a>00166             (void)<a class="code" href="sys__generic_8h.html#a910a2c6f5b5a4eadf3213bdfdd0b9bb1" title="Makes the current process sleep for some microseconds.">SYS_USleep</a>(100*1000); <span class="comment">/* 100 ms */</span>
<a name="l00167"></a>00167             <span class="keywordflow">goto</span> again;
<a name="l00168"></a>00168         }
<a name="l00169"></a>00169     }
<a name="l00170"></a>00170 
<a name="l00171"></a>00171 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00172"></a>00172 <span class="preprocessor"></span>    rv = (*IFDH_close_channel) (rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>);
<a name="l00173"></a>00173 <span class="preprocessor">#else</span>
<a name="l00174"></a>00174 <span class="preprocessor"></span>    rv = <a class="code" href="group__IFDHandler.html#ga372175bc1cb70ee90dc2f77ddf6275c3" title="This function should close the reader communication channel for the particular reader.">IFDHCloseChannel</a>(rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>);
<a name="l00175"></a>00175 <span class="preprocessor">#endif</span>
<a name="l00176"></a>00176 <span class="preprocessor"></span>
<a name="l00177"></a>00177     <span class="comment">/* END OF LOCKED REGION */</span>
<a name="l00178"></a>00178     (void)pthread_mutex_unlock(rContext-&gt;<a class="code" href="structReaderContext.html#a221ef594a986ccfa18dfafb5d7954bc1" title="Mutex for this connection.">mMutex</a>);
<a name="l00179"></a>00179 
<a name="l00180"></a>00180     <span class="keywordflow">return</span> rv;
<a name="l00181"></a>00181 }
<a name="l00182"></a>00182 
<a name="l00186"></a><a class="code" href="ifdwrapper_8h.html#ae0cd1971dc305040ce9308f6837f3f53">00186</a> LONG <a class="code" href="ifdwrapper_8c.html#a8cdbfd360837b39967cec4c75834250c" title="Set capabilities in the reader.">IFDSetCapabilities</a>(<a class="code" href="structReaderContext.html">READER_CONTEXT</a> * rContext, DWORD dwTag,
<a name="l00187"></a>00187             DWORD dwLength, PUCHAR pucValue)
<a name="l00188"></a>00188 {
<a name="l00189"></a>00189     RESPONSECODE rv = <a class="code" href="ifdhandler_8h.html#ae45ef2a236e5e6f15eb6b24a7bdf2d72" title="no error">IFD_SUCCESS</a>;
<a name="l00190"></a>00190 
<a name="l00191"></a>00191 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00192"></a>00192 <span class="preprocessor"></span>    RESPONSECODE(*IFDH_set_capabilities) (DWORD, DWORD, DWORD, PUCHAR) = NULL;
<a name="l00193"></a>00193 
<a name="l00194"></a>00194     IFDH_set_capabilities = rContext-&gt;<a class="code" href="structReaderContext.html#a627d54efaa512c2d1cc5d43367ee9420" title="driver functions">psFunctions</a>.<a class="code" href="structReaderContext.html#ab843b091726f4cb816f0f74c0318bc17" title="API V2.0.">psFunctions_v2</a>.pvfSetCapabilities;
<a name="l00195"></a>00195 <span class="preprocessor">#endif</span>
<a name="l00196"></a>00196 <span class="preprocessor"></span>
<a name="l00197"></a>00197     <span class="comment">/*</span>
<a name="l00198"></a>00198 <span class="comment">     * Let the calling function lock this otherwise a deadlock will</span>
<a name="l00199"></a>00199 <span class="comment">     * result</span>
<a name="l00200"></a>00200 <span class="comment">     */</span>
<a name="l00201"></a>00201 
<a name="l00202"></a>00202 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00203"></a>00203 <span class="preprocessor"></span>    rv = (*IFDH_set_capabilities) (rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>, dwTag,
<a name="l00204"></a>00204             dwLength, pucValue);
<a name="l00205"></a>00205 <span class="preprocessor">#else</span>
<a name="l00206"></a>00206 <span class="preprocessor"></span>    rv = <a class="code" href="group__IFDHandler.html#gab0ae04abb9850ccff194112bacd18fcb" title="This function should set the slot/card capabilities for a particular slot/card specified by Lun...">IFDHSetCapabilities</a>(rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>, dwTag, dwLength, pucValue);
<a name="l00207"></a>00207 <span class="preprocessor">#endif</span>
<a name="l00208"></a>00208 <span class="preprocessor"></span>
<a name="l00209"></a>00209     <span class="keywordflow">return</span> rv;
<a name="l00210"></a>00210 }
<a name="l00211"></a>00211 
<a name="l00217"></a><a class="code" href="ifdwrapper_8h.html#a8c10bb435569ebb9c85eee98ceab5d50">00217</a> LONG <a class="code" href="ifdwrapper_8c.html#af9ec3bb9c077c400c6c0bc4b4e19155f" title="Get&amp;#39;s capabilities in the reader.">IFDGetCapabilities</a>(<a class="code" href="structReaderContext.html">READER_CONTEXT</a> * rContext, DWORD dwTag,
<a name="l00218"></a>00218     PDWORD pdwLength, PUCHAR pucValue)
<a name="l00219"></a>00219 {
<a name="l00220"></a>00220     RESPONSECODE rv = <a class="code" href="ifdhandler_8h.html#ae45ef2a236e5e6f15eb6b24a7bdf2d72" title="no error">IFD_SUCCESS</a>;
<a name="l00221"></a>00221 
<a name="l00222"></a>00222 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00223"></a>00223 <span class="preprocessor"></span>    RESPONSECODE(*IFDH_get_capabilities) (DWORD, DWORD, PDWORD, <span class="comment">/*@out@*/</span> PUCHAR) = NULL;
<a name="l00224"></a>00224 
<a name="l00225"></a>00225     IFDH_get_capabilities =
<a name="l00226"></a>00226         rContext-&gt;<a class="code" href="structReaderContext.html#a627d54efaa512c2d1cc5d43367ee9420" title="driver functions">psFunctions</a>.<a class="code" href="structReaderContext.html#ab843b091726f4cb816f0f74c0318bc17" title="API V2.0.">psFunctions_v2</a>.pvfGetCapabilities;
<a name="l00227"></a>00227 <span class="preprocessor">#endif</span>
<a name="l00228"></a>00228 <span class="preprocessor"></span>
<a name="l00229"></a>00229     <span class="comment">/* LOCK THIS CODE REGION */</span>
<a name="l00230"></a>00230     (void)pthread_mutex_lock(rContext-&gt;<a class="code" href="structReaderContext.html#a221ef594a986ccfa18dfafb5d7954bc1" title="Mutex for this connection.">mMutex</a>);
<a name="l00231"></a>00231 
<a name="l00232"></a>00232 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00233"></a>00233 <span class="preprocessor"></span>    rv = (*IFDH_get_capabilities) (rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>, dwTag, pdwLength, pucValue);
<a name="l00234"></a>00234 <span class="preprocessor">#else</span>
<a name="l00235"></a>00235 <span class="preprocessor"></span>    rv = <a class="code" href="group__IFDHandler.html#ga799aa26945bbd3f61aaa57107f63ae0b" title="This function should get the slot/card capabilities for a particular slot/card specified by Lun...">IFDHGetCapabilities</a>(rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>, dwTag, pdwLength, pucValue);
<a name="l00236"></a>00236 <span class="preprocessor">#endif</span>
<a name="l00237"></a>00237 <span class="preprocessor"></span>
<a name="l00238"></a>00238     <span class="comment">/* END OF LOCKED REGION */</span>
<a name="l00239"></a>00239     (void)pthread_mutex_unlock(rContext-&gt;<a class="code" href="structReaderContext.html#a221ef594a986ccfa18dfafb5d7954bc1" title="Mutex for this connection.">mMutex</a>);
<a name="l00240"></a>00240 
<a name="l00241"></a>00241     <span class="keywordflow">return</span> rv;
<a name="l00242"></a>00242 }
<a name="l00243"></a>00243 
<a name="l00247"></a><a class="code" href="ifdwrapper_8h.html#adb9e6e7c6cec20f9fe73e5aa88b6d121">00247</a> LONG <a class="code" href="ifdwrapper_8c.html#a5a891c2a91b2cce4f950fe6d466ea9a2" title="Power up/down or reset&amp;#39;s an ICC located in the IFD.">IFDPowerICC</a>(<a class="code" href="structReaderContext.html">READER_CONTEXT</a> * rContext, DWORD dwAction,
<a name="l00248"></a>00248     PUCHAR pucAtr, PDWORD pdwAtrLen)
<a name="l00249"></a>00249 {
<a name="l00250"></a>00250     RESPONSECODE rv;
<a name="l00251"></a>00251     DWORD dwStatus;
<a name="l00252"></a>00252     UCHAR ucValue[1];
<a name="l00253"></a>00253     UCHAR dummyAtr[<a class="code" href="pcsclite_8h.html#a7ac7915ff6f9baefa66886c98bdbb91e" title="Maximum ATR size.">MAX_ATR_SIZE</a>];
<a name="l00254"></a>00254     DWORD dummyAtrLen = <span class="keyword">sizeof</span>(dummyAtr);
<a name="l00255"></a>00255 
<a name="l00256"></a>00256 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00257"></a>00257 <span class="preprocessor"></span>    RESPONSECODE(*IFDH_power_icc) (DWORD, DWORD, PUCHAR, PDWORD) = NULL;
<a name="l00258"></a>00258 <span class="preprocessor">#endif</span>
<a name="l00259"></a>00259 <span class="preprocessor"></span>
<a name="l00260"></a>00260     <span class="comment">/*</span>
<a name="l00261"></a>00261 <span class="comment">     * Zero out everything</span>
<a name="l00262"></a>00262 <span class="comment">     */</span>
<a name="l00263"></a>00263     dwStatus = 0;
<a name="l00264"></a>00264     ucValue[0] = 0;
<a name="l00265"></a>00265 
<a name="l00266"></a>00266     <span class="keywordflow">if</span> (NULL == pucAtr)
<a name="l00267"></a>00267         pucAtr = dummyAtr;
<a name="l00268"></a>00268     <span class="keywordflow">if</span> (NULL == pdwAtrLen)
<a name="l00269"></a>00269         pdwAtrLen = &amp;dummyAtrLen;
<a name="l00270"></a>00270 
<a name="l00271"></a>00271     <span class="comment">/*</span>
<a name="l00272"></a>00272 <span class="comment">     * Check that the card is inserted first</span>
<a name="l00273"></a>00273 <span class="comment">     */</span>
<a name="l00274"></a>00274     (void)<a class="code" href="ifdwrapper_8c.html#a53f77b110a7765f683e0629aad54772e" title="Provide statistical information about the IFD and ICC including insertions, atr, powering status/etc...">IFDStatusICC</a>(rContext, &amp;dwStatus);
<a name="l00275"></a>00275 
<a name="l00276"></a>00276     <span class="keywordflow">if</span> (dwStatus &amp; <a class="code" href="pcsclite_8h.html#a8108c39f71de4ea806b0a411eb9906ab" title="Card is absent.">SCARD_ABSENT</a>)
<a name="l00277"></a>00277         <span class="keywordflow">return</span> <a class="code" href="pcsclite_8h.html#aa2efd953946973972b1afc5d0343820c" title="The smart card has been removed, so further communication is not possible.">SCARD_W_REMOVED_CARD</a>;
<a name="l00278"></a>00278 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00279"></a>00279 <span class="preprocessor"></span>    IFDH_power_icc = rContext-&gt;<a class="code" href="structReaderContext.html#a627d54efaa512c2d1cc5d43367ee9420" title="driver functions">psFunctions</a>.<a class="code" href="structReaderContext.html#ab843b091726f4cb816f0f74c0318bc17" title="API V2.0.">psFunctions_v2</a>.pvfPowerICC;
<a name="l00280"></a>00280 <span class="preprocessor">#endif</span>
<a name="l00281"></a>00281 <span class="preprocessor"></span>
<a name="l00282"></a>00282     <span class="comment">/* LOCK THIS CODE REGION */</span>
<a name="l00283"></a>00283     (void)pthread_mutex_lock(rContext-&gt;<a class="code" href="structReaderContext.html#a221ef594a986ccfa18dfafb5d7954bc1" title="Mutex for this connection.">mMutex</a>);
<a name="l00284"></a>00284 
<a name="l00285"></a>00285 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00286"></a>00286 <span class="preprocessor"></span>    rv = (*IFDH_power_icc) (rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>, dwAction, pucAtr, pdwAtrLen);
<a name="l00287"></a>00287 <span class="preprocessor">#else</span>
<a name="l00288"></a>00288 <span class="preprocessor"></span>    rv = <a class="code" href="group__IFDHandler.html#gae6e70f53c76e9dab59164b2af8e9edfc" title="This function controls the power and reset signals of the smart card reader at the particular reader/...">IFDHPowerICC</a>(rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>, dwAction, pucAtr, pdwAtrLen);
<a name="l00289"></a>00289 <span class="preprocessor">#endif</span>
<a name="l00290"></a>00290 <span class="preprocessor"></span>
<a name="l00291"></a>00291     <span class="comment">/* END OF LOCKED REGION */</span>
<a name="l00292"></a>00292     (void)pthread_mutex_unlock(rContext-&gt;<a class="code" href="structReaderContext.html#a221ef594a986ccfa18dfafb5d7954bc1" title="Mutex for this connection.">mMutex</a>);
<a name="l00293"></a>00293 
<a name="l00294"></a>00294     <span class="comment">/* use clean values in case of error */</span>
<a name="l00295"></a>00295     <span class="keywordflow">if</span> (rv != <a class="code" href="ifdhandler_8h.html#ae45ef2a236e5e6f15eb6b24a7bdf2d72" title="no error">IFD_SUCCESS</a>)
<a name="l00296"></a>00296     {
<a name="l00297"></a>00297         *pdwAtrLen = 0;
<a name="l00298"></a>00298         pucAtr[0] = <span class="charliteral">&#39;\0&#39;</span>;
<a name="l00299"></a>00299 
<a name="l00300"></a>00300         <span class="keywordflow">if</span> (rv == <a class="code" href="ifdhandler_8h.html#a0a0d086b32b271a2172baebd65d9da9f" title="The IFD_NO_SUCH_DEVICE error must be returned by the driver when it detects the reader is no more pre...">IFD_NO_SUCH_DEVICE</a>)
<a name="l00301"></a>00301         {
<a name="l00302"></a>00302             (void)SendHotplugSignal();
<a name="l00303"></a>00303             <span class="keywordflow">return</span> <a class="code" href="pcsclite_8h.html#ad70bc694ffdf40c3b494d9239160d69d" title="The specified reader is not currently available for use.">SCARD_E_READER_UNAVAILABLE</a>;
<a name="l00304"></a>00304         }
<a name="l00305"></a>00305 
<a name="l00306"></a>00306         <span class="keywordflow">return</span> <a class="code" href="pcsclite_8h.html#ab02a33c2ef61f12a851dfe85c575d7cc" title="An attempt was made to end a non-existent transaction.">SCARD_E_NOT_TRANSACTED</a>;
<a name="l00307"></a>00307     }
<a name="l00308"></a>00308 
<a name="l00309"></a>00309     <span class="keywordflow">return</span> rv;
<a name="l00310"></a>00310 }
<a name="l00311"></a>00311 
<a name="l00316"></a><a class="code" href="ifdwrapper_8h.html#a2f61e2f53ab5a23841888ceb39ed882e">00316</a> LONG <a class="code" href="ifdwrapper_8c.html#a53f77b110a7765f683e0629aad54772e" title="Provide statistical information about the IFD and ICC including insertions, atr, powering status/etc...">IFDStatusICC</a>(<a class="code" href="structReaderContext.html">READER_CONTEXT</a> * rContext, PDWORD pdwStatus)
<a name="l00317"></a>00317 {
<a name="l00318"></a>00318     RESPONSECODE rv = <a class="code" href="ifdhandler_8h.html#ae45ef2a236e5e6f15eb6b24a7bdf2d72" title="no error">IFD_SUCCESS</a>;
<a name="l00319"></a>00319     DWORD dwCardStatus = 0;
<a name="l00320"></a>00320 
<a name="l00321"></a>00321 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00322"></a>00322 <span class="preprocessor"></span>    RESPONSECODE(*IFDH_icc_presence) (DWORD) = NULL;
<a name="l00323"></a>00323 
<a name="l00324"></a>00324     IFDH_icc_presence = rContext-&gt;<a class="code" href="structReaderContext.html#a627d54efaa512c2d1cc5d43367ee9420" title="driver functions">psFunctions</a>.<a class="code" href="structReaderContext.html#ab843b091726f4cb816f0f74c0318bc17" title="API V2.0.">psFunctions_v2</a>.pvfICCPresence;
<a name="l00325"></a>00325 <span class="preprocessor">#endif</span>
<a name="l00326"></a>00326 <span class="preprocessor"></span>
<a name="l00327"></a>00327     <span class="comment">/* LOCK THIS CODE REGION */</span>
<a name="l00328"></a>00328     (void)pthread_mutex_lock(rContext-&gt;<a class="code" href="structReaderContext.html#a221ef594a986ccfa18dfafb5d7954bc1" title="Mutex for this connection.">mMutex</a>);
<a name="l00329"></a>00329 
<a name="l00330"></a>00330 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00331"></a>00331 <span class="preprocessor"></span>    rv = (*IFDH_icc_presence) (rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>);
<a name="l00332"></a>00332 <span class="preprocessor">#else</span>
<a name="l00333"></a>00333 <span class="preprocessor"></span>    rv = <a class="code" href="group__IFDHandler.html#gac0ef46f09df179c44a82259468bea174" title="This function returns the status of the card inserted in the reader/slot specified by Lun...">IFDHICCPresence</a>(rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>);
<a name="l00334"></a>00334 <span class="preprocessor">#endif</span>
<a name="l00335"></a>00335 <span class="preprocessor"></span>
<a name="l00336"></a>00336     <span class="comment">/* END OF LOCKED REGION */</span>
<a name="l00337"></a>00337     (void)pthread_mutex_unlock(rContext-&gt;<a class="code" href="structReaderContext.html#a221ef594a986ccfa18dfafb5d7954bc1" title="Mutex for this connection.">mMutex</a>);
<a name="l00338"></a>00338 
<a name="l00339"></a>00339     <span class="keywordflow">if</span> (rv == <a class="code" href="ifdhandler_8h.html#ae45ef2a236e5e6f15eb6b24a7bdf2d72" title="no error">IFD_SUCCESS</a> || rv == <a class="code" href="ifdhandler_8h.html#a9ab7651d3879e7734375b8a6d82bb654" title="card is present">IFD_ICC_PRESENT</a>)
<a name="l00340"></a>00340         dwCardStatus |= <a class="code" href="pcsclite_8h.html#a4d99b1aacfcda4e1a36198f5668ae520" title="Card is present.">SCARD_PRESENT</a>;
<a name="l00341"></a>00341     <span class="keywordflow">else</span>
<a name="l00342"></a>00342         <span class="keywordflow">if</span> (rv == <a class="code" href="ifdhandler_8h.html#ad17dec712379cf6032b6d9cf172ab9c8" title="card is absent">IFD_ICC_NOT_PRESENT</a>)
<a name="l00343"></a>00343             dwCardStatus |= <a class="code" href="pcsclite_8h.html#a8108c39f71de4ea806b0a411eb9906ab" title="Card is absent.">SCARD_ABSENT</a>;
<a name="l00344"></a>00344         <span class="keywordflow">else</span>
<a name="l00345"></a>00345         {
<a name="l00346"></a>00346             Log2(PCSC_LOG_ERROR, <span class="stringliteral">&quot;Card not transacted: %ld&quot;</span>, rv);
<a name="l00347"></a>00347             *pdwStatus = <a class="code" href="pcsclite_8h.html#a91be8317d47fab4b3eac201850fa917f" title="Unknown state.">SCARD_UNKNOWN</a>;
<a name="l00348"></a>00348 
<a name="l00349"></a>00349             <span class="keywordflow">if</span> (rv == <a class="code" href="ifdhandler_8h.html#a0a0d086b32b271a2172baebd65d9da9f" title="The IFD_NO_SUCH_DEVICE error must be returned by the driver when it detects the reader is no more pre...">IFD_NO_SUCH_DEVICE</a>)
<a name="l00350"></a>00350             {
<a name="l00351"></a>00351                 (void)SendHotplugSignal();
<a name="l00352"></a>00352                 <span class="keywordflow">return</span> <a class="code" href="pcsclite_8h.html#ad70bc694ffdf40c3b494d9239160d69d" title="The specified reader is not currently available for use.">SCARD_E_READER_UNAVAILABLE</a>;
<a name="l00353"></a>00353             }
<a name="l00354"></a>00354 
<a name="l00355"></a>00355             <span class="keywordflow">return</span> <a class="code" href="pcsclite_8h.html#ab02a33c2ef61f12a851dfe85c575d7cc" title="An attempt was made to end a non-existent transaction.">SCARD_E_NOT_TRANSACTED</a>;
<a name="l00356"></a>00356         }
<a name="l00357"></a>00357 
<a name="l00358"></a>00358     *pdwStatus = dwCardStatus;
<a name="l00359"></a>00359 
<a name="l00360"></a>00360     <span class="keywordflow">return</span> <a class="code" href="pcsclite_8h.html#a4a3c56f69570971d366642a563b34a75" title="error codes from http://msdn.microsoft.com/en-us/library/aa924526.aspx">SCARD_S_SUCCESS</a>;
<a name="l00361"></a>00361 }
<a name="l00362"></a>00362 
<a name="l00363"></a>00363 <span class="comment">/*</span>
<a name="l00364"></a>00364 <span class="comment"> * Function: IFDControl Purpose : This function provides a means for</span>
<a name="l00365"></a>00365 <span class="comment"> * toggling a specific action on the reader such as swallow, eject,</span>
<a name="l00366"></a>00366 <span class="comment"> * biometric.</span>
<a name="l00367"></a>00367 <span class="comment"> */</span>
<a name="l00368"></a>00368 
<a name="l00369"></a>00369 <span class="comment">/*</span>
<a name="l00370"></a>00370 <span class="comment"> * Valid only for IFDHandler version 2.0</span>
<a name="l00371"></a>00371 <span class="comment"> */</span>
<a name="l00372"></a>00372 
<a name="l00373"></a>00373 LONG IFDControl_v2(<a class="code" href="structReaderContext.html">READER_CONTEXT</a> * rContext, PUCHAR TxBuffer,
<a name="l00374"></a>00374     DWORD TxLength, PUCHAR RxBuffer, PDWORD RxLength)
<a name="l00375"></a>00375 {
<a name="l00376"></a>00376     RESPONSECODE rv = <a class="code" href="ifdhandler_8h.html#ae45ef2a236e5e6f15eb6b24a7bdf2d72" title="no error">IFD_SUCCESS</a>;
<a name="l00377"></a>00377 
<a name="l00378"></a>00378 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00379"></a>00379 <span class="preprocessor"></span>    RESPONSECODE(*IFDH_control_v2) (DWORD, PUCHAR, DWORD, <span class="comment">/*@out@*/</span> PUCHAR,
<a name="l00380"></a>00380         PDWORD);
<a name="l00381"></a>00381 <span class="preprocessor">#endif</span>
<a name="l00382"></a>00382 <span class="preprocessor"></span>
<a name="l00383"></a>00383     <span class="keywordflow">if</span> (rContext-&gt;<a class="code" href="structReaderContext.html#aad880fc4455c253781e8968f2239d56f" title="IFD Handler version number.">version</a> != IFD_HVERSION_2_0)
<a name="l00384"></a>00384         <span class="keywordflow">return</span> <a class="code" href="pcsclite_8h.html#aef39984cd0dd3822088099fffd9d5f96" title="This smart card does not support the requested feature.">SCARD_E_UNSUPPORTED_FEATURE</a>;
<a name="l00385"></a>00385 
<a name="l00386"></a>00386 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00387"></a>00387 <span class="preprocessor"></span>    IFDH_control_v2 = rContext-&gt;<a class="code" href="structReaderContext.html#a627d54efaa512c2d1cc5d43367ee9420" title="driver functions">psFunctions</a>.<a class="code" href="structReaderContext.html#ab843b091726f4cb816f0f74c0318bc17" title="API V2.0.">psFunctions_v2</a>.pvfControl;
<a name="l00388"></a>00388 <span class="preprocessor">#endif</span>
<a name="l00389"></a>00389 <span class="preprocessor"></span>
<a name="l00390"></a>00390     <span class="comment">/* LOCK THIS CODE REGION */</span>
<a name="l00391"></a>00391     (void)pthread_mutex_lock(rContext-&gt;<a class="code" href="structReaderContext.html#a221ef594a986ccfa18dfafb5d7954bc1" title="Mutex for this connection.">mMutex</a>);
<a name="l00392"></a>00392 
<a name="l00393"></a>00393 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00394"></a>00394 <span class="preprocessor"></span>    rv = (*IFDH_control_v2) (rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>, TxBuffer, TxLength,
<a name="l00395"></a>00395         RxBuffer, RxLength);
<a name="l00396"></a>00396 <span class="preprocessor">#elif defined(IFDHANDLERv2)</span>
<a name="l00397"></a>00397 <span class="preprocessor"></span>    rv = <a class="code" href="group__IFDHandler.html#gabc775e84456eab0bac55df678a147dc9" title="This function performs a data exchange with the reader (not the card) specified by Lun...">IFDHControl</a>(rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>, TxBuffer, TxLength,
<a name="l00398"></a>00398         RxBuffer, RxLength);
<a name="l00399"></a>00399 <span class="preprocessor">#endif</span>
<a name="l00400"></a>00400 <span class="preprocessor"></span>
<a name="l00401"></a>00401     <span class="comment">/* END OF LOCKED REGION */</span>
<a name="l00402"></a>00402     (void)pthread_mutex_unlock(rContext-&gt;<a class="code" href="structReaderContext.html#a221ef594a986ccfa18dfafb5d7954bc1" title="Mutex for this connection.">mMutex</a>);
<a name="l00403"></a>00403 
<a name="l00404"></a>00404     <span class="keywordflow">if</span> (rv == <a class="code" href="ifdhandler_8h.html#ae45ef2a236e5e6f15eb6b24a7bdf2d72" title="no error">IFD_SUCCESS</a>)
<a name="l00405"></a>00405         <span class="keywordflow">return</span> <a class="code" href="pcsclite_8h.html#a4a3c56f69570971d366642a563b34a75" title="error codes from http://msdn.microsoft.com/en-us/library/aa924526.aspx">SCARD_S_SUCCESS</a>;
<a name="l00406"></a>00406     <span class="keywordflow">else</span>
<a name="l00407"></a>00407     {
<a name="l00408"></a>00408         Log2(PCSC_LOG_ERROR, <span class="stringliteral">&quot;Card not transacted: %ld&quot;</span>, rv);
<a name="l00409"></a>00409         LogXxd(PCSC_LOG_DEBUG, <span class="stringliteral">&quot;TxBuffer &quot;</span>, TxBuffer, TxLength);
<a name="l00410"></a>00410         LogXxd(PCSC_LOG_DEBUG, <span class="stringliteral">&quot;RxBuffer &quot;</span>, RxBuffer, *RxLength);
<a name="l00411"></a>00411         <span class="keywordflow">return</span> <a class="code" href="pcsclite_8h.html#ab02a33c2ef61f12a851dfe85c575d7cc" title="An attempt was made to end a non-existent transaction.">SCARD_E_NOT_TRANSACTED</a>;
<a name="l00412"></a>00412     }
<a name="l00413"></a>00413 }
<a name="l00414"></a>00414 
<a name="l00420"></a>00420 <span class="comment">/*</span>
<a name="l00421"></a>00421 <span class="comment"> * Valid only for IFDHandler version 3.0 and up</span>
<a name="l00422"></a>00422 <span class="comment"> */</span>
<a name="l00423"></a>00423 
<a name="l00424"></a><a class="code" href="ifdwrapper_8h.html#a640e9b4f8a9849ddbc10b59d937b0d45">00424</a> LONG <a class="code" href="ifdwrapper_8c.html#a3a32c91bea8a53ae2b53f8ae821294c5" title="Provide a means for toggling a specific action on the reader such as swallow, eject, biometric.">IFDControl</a>(<a class="code" href="structReaderContext.html">READER_CONTEXT</a> * rContext, DWORD ControlCode,
<a name="l00425"></a>00425     LPCVOID TxBuffer, DWORD TxLength, LPVOID RxBuffer, DWORD RxLength,
<a name="l00426"></a>00426     LPDWORD BytesReturned)
<a name="l00427"></a>00427 {
<a name="l00428"></a>00428     RESPONSECODE rv = <a class="code" href="ifdhandler_8h.html#ae45ef2a236e5e6f15eb6b24a7bdf2d72" title="no error">IFD_SUCCESS</a>;
<a name="l00429"></a>00429 
<a name="l00430"></a>00430 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00431"></a>00431 <span class="preprocessor"></span>    RESPONSECODE(*IFDH_control) (DWORD, DWORD, LPCVOID, DWORD, LPVOID, DWORD, LPDWORD);
<a name="l00432"></a>00432 <span class="preprocessor">#endif</span>
<a name="l00433"></a>00433 <span class="preprocessor"></span>
<a name="l00434"></a>00434     <span class="keywordflow">if</span> (rContext-&gt;<a class="code" href="structReaderContext.html#aad880fc4455c253781e8968f2239d56f" title="IFD Handler version number.">version</a> &lt; IFD_HVERSION_3_0)
<a name="l00435"></a>00435         <span class="keywordflow">return</span> <a class="code" href="pcsclite_8h.html#aef39984cd0dd3822088099fffd9d5f96" title="This smart card does not support the requested feature.">SCARD_E_UNSUPPORTED_FEATURE</a>;
<a name="l00436"></a>00436 
<a name="l00437"></a>00437 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00438"></a>00438 <span class="preprocessor"></span>    IFDH_control = rContext-&gt;<a class="code" href="structReaderContext.html#a627d54efaa512c2d1cc5d43367ee9420" title="driver functions">psFunctions</a>.<a class="code" href="structReaderContext.html#a2419b85252a2e83704c6c98222ccc37a" title="API V3.0.">psFunctions_v3</a>.pvfControl;
<a name="l00439"></a>00439 <span class="preprocessor">#endif</span>
<a name="l00440"></a>00440 <span class="preprocessor"></span>
<a name="l00441"></a>00441     <span class="comment">/* LOCK THIS CODE REGION */</span>
<a name="l00442"></a>00442     (void)pthread_mutex_lock(rContext-&gt;<a class="code" href="structReaderContext.html#a221ef594a986ccfa18dfafb5d7954bc1" title="Mutex for this connection.">mMutex</a>);
<a name="l00443"></a>00443 
<a name="l00444"></a>00444 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00445"></a>00445 <span class="preprocessor"></span>    rv = (*IFDH_control) (rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>, ControlCode, TxBuffer,
<a name="l00446"></a>00446         TxLength, RxBuffer, RxLength, BytesReturned);
<a name="l00447"></a>00447 <span class="preprocessor">#elif defined(IFDHANDLERv3)</span>
<a name="l00448"></a>00448 <span class="preprocessor"></span>    rv = <a class="code" href="group__IFDHandler.html#gabc775e84456eab0bac55df678a147dc9" title="This function performs a data exchange with the reader (not the card) specified by Lun...">IFDHControl</a>(rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>, ControlCode, TxBuffer,
<a name="l00449"></a>00449         TxLength, RxBuffer, RxLength, BytesReturned);
<a name="l00450"></a>00450 <span class="preprocessor">#endif</span>
<a name="l00451"></a>00451 <span class="preprocessor"></span>
<a name="l00452"></a>00452     <span class="comment">/* END OF LOCKED REGION */</span>
<a name="l00453"></a>00453     (void)pthread_mutex_unlock(rContext-&gt;<a class="code" href="structReaderContext.html#a221ef594a986ccfa18dfafb5d7954bc1" title="Mutex for this connection.">mMutex</a>);
<a name="l00454"></a>00454 
<a name="l00455"></a>00455     <span class="keywordflow">if</span> (rv == <a class="code" href="ifdhandler_8h.html#ae45ef2a236e5e6f15eb6b24a7bdf2d72" title="no error">IFD_SUCCESS</a>)
<a name="l00456"></a>00456         <span class="keywordflow">return</span> <a class="code" href="pcsclite_8h.html#a4a3c56f69570971d366642a563b34a75" title="error codes from http://msdn.microsoft.com/en-us/library/aa924526.aspx">SCARD_S_SUCCESS</a>;
<a name="l00457"></a>00457     <span class="keywordflow">else</span>
<a name="l00458"></a>00458     {
<a name="l00459"></a>00459         Log2(PCSC_LOG_ERROR, <span class="stringliteral">&quot;Card not transacted: %ld&quot;</span>, rv);
<a name="l00460"></a>00460         Log3(PCSC_LOG_DEBUG, <span class="stringliteral">&quot;ControlCode: 0x%.8LX BytesReturned: %ld&quot;</span>,
<a name="l00461"></a>00461             ControlCode, *BytesReturned);
<a name="l00462"></a>00462         LogXxd(PCSC_LOG_DEBUG, <span class="stringliteral">&quot;TxBuffer &quot;</span>, TxBuffer, TxLength);
<a name="l00463"></a>00463         LogXxd(PCSC_LOG_DEBUG, <span class="stringliteral">&quot;RxBuffer &quot;</span>, RxBuffer, *BytesReturned);
<a name="l00464"></a>00464 
<a name="l00465"></a>00465         <span class="keywordflow">if</span> (rv == <a class="code" href="ifdhandler_8h.html#a0a0d086b32b271a2172baebd65d9da9f" title="The IFD_NO_SUCH_DEVICE error must be returned by the driver when it detects the reader is no more pre...">IFD_NO_SUCH_DEVICE</a>)
<a name="l00466"></a>00466         {
<a name="l00467"></a>00467             (void)SendHotplugSignal();
<a name="l00468"></a>00468             <span class="keywordflow">return</span> <a class="code" href="pcsclite_8h.html#ad70bc694ffdf40c3b494d9239160d69d" title="The specified reader is not currently available for use.">SCARD_E_READER_UNAVAILABLE</a>;
<a name="l00469"></a>00469         }
<a name="l00470"></a>00470 
<a name="l00471"></a>00471         <span class="keywordflow">if</span> ((IFD_ERROR_NOT_SUPPORTED == rv) || (<a class="code" href="ifdhandler_8h.html#a35aea7275c1fcb4e97d57f6c8fa28918" title="request is not supported">IFD_NOT_SUPPORTED</a> == rv))
<a name="l00472"></a>00472             <span class="keywordflow">return</span> <a class="code" href="pcsclite_8h.html#aef39984cd0dd3822088099fffd9d5f96" title="This smart card does not support the requested feature.">SCARD_E_UNSUPPORTED_FEATURE</a>;
<a name="l00473"></a>00473 
<a name="l00474"></a>00474         <span class="keywordflow">if</span> (<a class="code" href="ifdhandler_8h.html#a98d6e54de9a99c288b9732231a040073" title="buffer is too small">IFD_ERROR_INSUFFICIENT_BUFFER</a> ==rv)
<a name="l00475"></a>00475             <span class="keywordflow">return</span> <a class="code" href="pcsclite_8h.html#aac3f8d945f8a0e667e0926daaa18dc57" title="The data buffer to receive returned data is too small for the returned data.">SCARD_E_INSUFFICIENT_BUFFER</a>;
<a name="l00476"></a>00476 
<a name="l00477"></a>00477         <span class="keywordflow">return</span> <a class="code" href="pcsclite_8h.html#ab02a33c2ef61f12a851dfe85c575d7cc" title="An attempt was made to end a non-existent transaction.">SCARD_E_NOT_TRANSACTED</a>;
<a name="l00478"></a>00478     }
<a name="l00479"></a>00479 }
<a name="l00480"></a>00480 
<a name="l00484"></a><a class="code" href="ifdwrapper_8h.html#ae909ca1bd734986481f926040f96196c">00484</a> LONG <a class="code" href="ifdwrapper_8c.html#a5c09051f18604f829349702ed226257e" title="Transmit an APDU to the ICC.">IFDTransmit</a>(<a class="code" href="structReaderContext.html">READER_CONTEXT</a> * rContext, <a class="code" href="struct__SCARD__IO__HEADER.html" title="Use by SCardTransmit()">SCARD_IO_HEADER</a> pioTxPci,
<a name="l00485"></a>00485     PUCHAR pucTxBuffer, DWORD dwTxLength, PUCHAR pucRxBuffer,
<a name="l00486"></a>00486     PDWORD pdwRxLength, <a class="code" href="struct__SCARD__IO__HEADER.html" title="Use by SCardTransmit()">PSCARD_IO_HEADER</a> pioRxPci)
<a name="l00487"></a>00487 {
<a name="l00488"></a>00488     RESPONSECODE rv = <a class="code" href="ifdhandler_8h.html#ae45ef2a236e5e6f15eb6b24a7bdf2d72" title="no error">IFD_SUCCESS</a>;
<a name="l00489"></a>00489 
<a name="l00490"></a>00490 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00491"></a>00491 <span class="preprocessor"></span>    RESPONSECODE(*IFDH_transmit_to_icc) (DWORD, <a class="code" href="ifdhandler_8h.html#a43943c1504e1306b4381181d5026986e" title="Use by SCardTransmit()">SCARD_IO_HEADER</a>, PUCHAR,
<a name="l00492"></a>00492         DWORD, <span class="comment">/*@out@*/</span> PUCHAR, PDWORD, <a class="code" href="struct__SCARD__IO__HEADER.html" title="Use by SCardTransmit()">PSCARD_IO_HEADER</a>) = NULL;
<a name="l00493"></a>00493 <span class="preprocessor">#endif</span>
<a name="l00494"></a>00494 <span class="preprocessor"></span>
<a name="l00495"></a>00495     <span class="comment">/* log the APDU */</span>
<a name="l00496"></a>00496     DebugLogCategory(DEBUG_CATEGORY_APDU, pucTxBuffer, dwTxLength);
<a name="l00497"></a>00497 
<a name="l00498"></a>00498 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00499"></a>00499 <span class="preprocessor"></span>    IFDH_transmit_to_icc =
<a name="l00500"></a>00500         rContext-&gt;<a class="code" href="structReaderContext.html#a627d54efaa512c2d1cc5d43367ee9420" title="driver functions">psFunctions</a>.<a class="code" href="structReaderContext.html#ab843b091726f4cb816f0f74c0318bc17" title="API V2.0.">psFunctions_v2</a>.pvfTransmitToICC;
<a name="l00501"></a>00501 <span class="preprocessor">#endif</span>
<a name="l00502"></a>00502 <span class="preprocessor"></span>
<a name="l00503"></a>00503     <span class="comment">/* LOCK THIS CODE REGION */</span>
<a name="l00504"></a>00504     (void)pthread_mutex_lock(rContext-&gt;<a class="code" href="structReaderContext.html#a221ef594a986ccfa18dfafb5d7954bc1" title="Mutex for this connection.">mMutex</a>);
<a name="l00505"></a>00505 
<a name="l00506"></a>00506 <span class="preprocessor">#ifndef PCSCLITE_STATIC_DRIVER</span>
<a name="l00507"></a>00507 <span class="preprocessor"></span>    rv = (*IFDH_transmit_to_icc) (rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>, pioTxPci, (LPBYTE)
<a name="l00508"></a>00508         pucTxBuffer, dwTxLength, pucRxBuffer, pdwRxLength, pioRxPci);
<a name="l00509"></a>00509 <span class="preprocessor">#else</span>
<a name="l00510"></a>00510 <span class="preprocessor"></span>    rv = <a class="code" href="group__IFDHandler.html#gac86e07f01d11accda93fb80d3935eeed" title="This function performs an APDU exchange with the card/slot specified by Lun.">IFDHTransmitToICC</a>(rContext-&gt;<a class="code" href="structReaderContext.html#a83d6e2127b4cc5e01f2012608487d31a" title="Current Reader Slot.">slot</a>, pioTxPci,
<a name="l00511"></a>00511         (LPBYTE) pucTxBuffer, dwTxLength,
<a name="l00512"></a>00512         pucRxBuffer, pdwRxLength, pioRxPci);
<a name="l00513"></a>00513 <span class="preprocessor">#endif</span>
<a name="l00514"></a>00514 <span class="preprocessor"></span>
<a name="l00515"></a>00515     <span class="comment">/* END OF LOCKED REGION */</span>
<a name="l00516"></a>00516     (void)pthread_mutex_unlock(rContext-&gt;<a class="code" href="structReaderContext.html#a221ef594a986ccfa18dfafb5d7954bc1" title="Mutex for this connection.">mMutex</a>);
<a name="l00517"></a>00517 
<a name="l00518"></a>00518     <span class="comment">/* log the returned status word */</span>
<a name="l00519"></a>00519     DebugLogCategory(DEBUG_CATEGORY_SW, pucRxBuffer, *pdwRxLength);
<a name="l00520"></a>00520 
<a name="l00521"></a>00521     <span class="keywordflow">if</span> (rv == <a class="code" href="ifdhandler_8h.html#ae45ef2a236e5e6f15eb6b24a7bdf2d72" title="no error">IFD_SUCCESS</a>)
<a name="l00522"></a>00522         <span class="keywordflow">return</span> <a class="code" href="pcsclite_8h.html#a4a3c56f69570971d366642a563b34a75" title="error codes from http://msdn.microsoft.com/en-us/library/aa924526.aspx">SCARD_S_SUCCESS</a>;
<a name="l00523"></a>00523     <span class="keywordflow">else</span>
<a name="l00524"></a>00524     {
<a name="l00525"></a>00525         Log2(PCSC_LOG_ERROR, <span class="stringliteral">&quot;Card not transacted: %ld&quot;</span>, rv);
<a name="l00526"></a>00526 
<a name="l00527"></a>00527         <span class="keywordflow">if</span> (rv == <a class="code" href="ifdhandler_8h.html#a0a0d086b32b271a2172baebd65d9da9f" title="The IFD_NO_SUCH_DEVICE error must be returned by the driver when it detects the reader is no more pre...">IFD_NO_SUCH_DEVICE</a>)
<a name="l00528"></a>00528         {
<a name="l00529"></a>00529             (void)SendHotplugSignal();
<a name="l00530"></a>00530             <span class="keywordflow">return</span> <a class="code" href="pcsclite_8h.html#ad70bc694ffdf40c3b494d9239160d69d" title="The specified reader is not currently available for use.">SCARD_E_READER_UNAVAILABLE</a>;
<a name="l00531"></a>00531         }
<a name="l00532"></a>00532 
<a name="l00533"></a>00533         <span class="keywordflow">return</span> <a class="code" href="pcsclite_8h.html#ab02a33c2ef61f12a851dfe85c575d7cc" title="An attempt was made to end a non-existent transaction.">SCARD_E_NOT_TRANSACTED</a>;
<a name="l00534"></a>00534     }
<a name="l00535"></a>00535 }
<a name="l00536"></a>00536 
</pre></div></div>
</div>
<hr class="footer"/><address class="footer"><small>Generated on Thu Mar 31 2011 for pcsc-lite by&#160;
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </small></address>
</body>
</html>