[Pcsclite-git-commit] [PCSC] 05/11: Doxygen: SCardTransmit pioRecvPci is optional

[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 aed8486d13da8de4a77b620e28c617cc9cb18cd9
Author: Ludovic Rousseau <ludovic.rousseau at free.fr>
Date:   Fri Mar 11 10:09:27 2016 +0100

    Doxygen: SCardTransmit pioRecvPci is optional
    
    The parameter pioRecvPci of SCardTransmit() is optional and can be NULL.
    
    In fact this parameter is not used/modified by pcsc-lite or the libccid
    driver.
    
    Thanks to Maksim Ivanov for the bug report
    http://lists.alioth.debian.org/pipermail/pcsclite-muscle/Week-of-Mon-20160307/000536.html
---
 src/winscard_clnt.c | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/src/winscard_clnt.c b/src/winscard_clnt.c
index 5f675a8..1c208fc 100644
--- a/src/winscard_clnt.c
+++ b/src/winscard_clnt.c
@@ -2558,7 +2558,7 @@ end:
  * - \ref SCARD_PCI_RAW - Predefined RAW PCI structure.
  * @param[in] pbSendBuffer APDU to send to the card.
  * @param[in] cbSendLength Length of the APDU.
- * @param[in,out] pioRecvPci Structure of protocol information.
+ * @param[in,out] pioRecvPci Structure of protocol information. This parameter can be NULL if no PCI is returned.
  * @param[out] pbRecvBuffer Response from the card.
  * @param[in,out] pcbRecvLength Length of the response.
  *
@@ -2581,7 +2581,6 @@ end:
  * SCARDCONTEXT hContext;
  * SCARDHANDLE hCard;
  * DWORD dwActiveProtocol, dwSendLength, dwRecvLength;
- * SCARD_IO_REQUEST pioRecvPci;
  * BYTE pbRecvBuffer[10];
  * BYTE pbSendBuffer[] = { 0xC0, 0xA4, 0x00, 0x00, 0x02, 0x3F, 0x00 };
  * ...
@@ -2591,7 +2590,7 @@ end:
  * dwSendLength = sizeof(pbSendBuffer);
  * dwRecvLength = sizeof(pbRecvBuffer);
  * rv = SCardTransmit(hCard, SCARD_PCI_T0, pbSendBuffer, dwSendLength,
- *          &pioRecvPci, pbRecvBuffer, &dwRecvLength);
+ *          NULL, pbRecvBuffer, &dwRecvLength);
  * @endcode
  */
 LONG SCardTransmit(SCARDHANDLE hCard, const SCARD_IO_REQUEST *pioSendPci,

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