[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}