[Pcsclite-cvs-commit] CVS PCSC/doc

CVS User rousseau ludovic.rousseau@free.fr
Mon, 28 Feb 2005 06:45:49 -0700


Update of /cvsroot/pcsclite/PCSC/doc
In directory haydn:/tmp/cvs-serv25980

Modified Files:
	pcsc-lite.tex 
Log Message:
improve SCardGetStatusChange() documentation


--- /cvsroot/pcsclite/PCSC/doc/pcsc-lite.tex	2004/11/23 21:08:11	1.12
+++ /cvsroot/pcsclite/PCSC/doc/pcsc-lite.tex	2005/02/28 13:45:44	1.13
@@ -5,7 +5,7 @@
 %  David Corcoran <corcoran@linuxnet.com>
 %  Ludovic Rousseau <ludovic.rousseau@free.fr>
 %
-% $Id: pcsc-lite.tex,v 1.12 2004/11/23 21:08:11 rousseau Exp $
+% $Id: pcsc-lite.tex,v 1.13 2005/02/28 13:45:44 rousseau Exp $
 
 \documentclass[a4paper,12pt]{article}
 
@@ -1102,9 +1102,10 @@
 
 \parameters
 
-\begin{tabular}{lll}
+\begin{tabular}{llp{10cm}}
 \texttt{hContext} &	IN &	Connection context to the PC/SC Resource Manager\\
-\texttt{dwTimeout} &	IN &	Maximum block waiting time for status change, zero for infinite\\
+\texttt{dwTimeout} &	IN &	Maximum waiting time (in miliseconds)
+for status change, zero (or \texttt{INFINITE}) for infinite\\
 \texttt{rgReaderStates} & INOUT & Structures of readers with current states\\
 \texttt{cReaders} &	IN &	Number of structures\\
 \end{tabular}
@@ -1192,20 +1193,16 @@
 
 \begin{verbatim}
 SCARDCONTEXT hContext;
-SCARDHANDLE hCard;
-DWORD dwActiveProtocol, cReaders;
 SCARD_READERSTATE_A rgReaderStates[1];
 LONG rv;
 
 rv = SCardEstablishContext(SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext);
 
-rgReaderStates[0].szReader = strdup("Reader X");
-rgReaderStates[0].dwCurrentState = SCARD_STATE_EMPTY;
+rgReaderStates[0].szReader = "Reader X";
+rgReaderStates[0].dwCurrentState = SCARD_STATE_UNAWARE;
 
-cReaders = 1;
-rv = SCardGetStatusChange(hContext, INFINITE, rgReaderStates, cReaders);
-rv = SCardConnect(hContext, "Reader X", SCARD_SHARE_SHARED,
-         SCARD_PROTOCOL_T0, &hCard, &dwActiveProtocol);
+rv = SCardGetStatusChange(hContext, INFINITE, rgReaderStates, 1);
+printf("reader state: 0x%04X\n", rgReaderStates[0].dwEventState);
 \end{verbatim}