[Pcsclite-cvs-commit] r5291 - /trunk/PCSC/src/winscard_clnt.c

[rousseau at users.alioth.debian.org]

Author: rousseau
Date: Sun Oct 10 18:22:40 2010
New Revision: 5291

URL: http://svn.debian.org/wsvn/pcsclite/?sc=1&rev=5291
Log:
Doxygen SCardStatus(): *pdwState also contains a number of events

Modified:
    trunk/PCSC/src/winscard_clnt.c

Modified: trunk/PCSC/src/winscard_clnt.c
URL: http://svn.debian.org/wsvn/pcsclite/trunk/PCSC/src/winscard_clnt.c?rev=5291&op=diff
==============================================================================
--- trunk/PCSC/src/winscard_clnt.c (original)
+++ trunk/PCSC/src/winscard_clnt.c Sun Oct 10 18:22:40 2010
@@ -1480,6 +1480,12 @@
  * and the necessary size in \p pcchReaderLen and \p pcbAtrLen. The current
  * state, and protocol will be stored in pdwState and \p pdwProtocol
  * respectively.
+ *
+ * *pdwState also contains a number of events in the upper 16 bits
+ * (*pdwState & 0xFFFF0000). This number of events is incremented
+ * for each card insertion or removal in the specified reader. This can
+ * be used to detect a card removal/insertion between two calls to
+ * SCardStatus()
  *
  * If \c *pcchReaderLen is equal to \ref SCARD_AUTOALLOCATE then the function
  * will allocate itself the needed memory for mszReaderName. Use