[Pcsclite-git-commit] [PCSC] 02/03: Doxygen: improve SCardGetStatusChange example

[Ludovic Rousseau]

This is an automated email from the git hooks/post-receive script.

rousseau pushed a commit to branch master
in repository PCSC.

commit 0ba8145d814b846f2f2c2c59ad82e34f1253159a
Author: Ludovic Rousseau <ludovic.rousseau at free.fr>
Date:   Fri May 27 18:57:19 2016 +0200

    Doxygen: improve SCardGetStatusChange example
    
    Show how to wait for a card insertion.
---
 src/winscard_clnt.c | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/src/winscard_clnt.c b/src/winscard_clnt.c
index ea480de..94d4cf5 100644
--- a/src/winscard_clnt.c
+++ b/src/winscard_clnt.c
@@ -1624,9 +1624,17 @@ end:
  * rgReaderStates[1].szReader = "\\\\?PnP?\\Notification";
  * rgReaderStates[1].dwCurrentState = SCARD_STATE_UNAWARE;
  * ...
+ * // Get current state
  * rv = SCardGetStatusChange(hContext, INFINITE, rgReaderStates, 2);
  * printf("reader state: 0x%04X\n", rgReaderStates[0].dwEventState);
  * printf("reader state: 0x%04X\n", rgReaderStates[1].dwEventState);
+ *
+ * // Wait for card insertion
+ * if (rgReaderStates[0].dwEventState & SCARD_STATE_EMPTY)
+ * {
+ *     rgReaderStates[0].dwCurrentState = rgReaderStates[0].dwEventState;
+ *     rv = SCardGetStatusChange(hContext, INFINITE, rgReaderStates, 2);
+ * }
  * @endcode
  */
 LONG SCardGetStatusChange(SCARDCONTEXT hContext, DWORD dwTimeout,

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pcsclite/PCSC.git