Microsoft Windows CE 3.0  

SmartcardDeviceControl

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

The SmartcardDeviceControlfunction is the main entry function for the smart card driver library. It performs parameter checking and completes calls that do not require I/O with the smart card reader.

NTSTATUS SmartcardDeviceControl(
PSMARTCARD_EXTENSION
SmartcardExtension, 
PBYTE
pInBuf, 
DWORD
nInBufSize, 
PBYTE
pOutBuf, 
DWORD
nOutBufSize, 
PDWORD
pBytesReturned
);

Parameters

SmartcardExtension
Points to the smart card structure of the driver.
pInBuf
Same as the driver entrypoint PSC_DeviceIOControl pInBufparameter.
nInBufSize
Same as the driver entrypoint PSC_DeviceIOControl nInBufSizeparameter.
pOutBuf
Same as the driver entrypoint PSC_DeviceIOControl pOutBufparameter.
nOutBufSize
Same as the driver entrypoint PSC_DeviceIOControl nOutBufSizeparameter.
pBytesReturned
Same as the driver entrypoint PSC_DeviceIOControl pBytesReturnedparameter.

Return Values

SmartcardDeviceControlreturns the NTSTATUS value of the called routine.

Remarks

The driver's XXX_IOControlroutine must call this function to let the library check parameters and complete calls that do not need to do I/O with the reader.

The smart card driver library checks the version of the SMARTCARD_EXTENSIONstructure. Before calling SmartcardDeviceControl, the driver must assign to the Versionmember of SMARTCARD_EXTENSIONthe value SMCLIB_VERSION. This is usually done in the PSC_Deinitroutine.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 3.0 and later      
Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.


 Last updated on Tuesday, July 13, 2004

© 2004 Microsoft Corporation. All rights reserved.