SmartcardDeviceControl
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
The SmartcardDeviceControl function 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.
Syntax
NTSTATUS SmartcardDeviceControl(
PSMARTCARD_EXTENSION SmartcardExtension,
PBYTE pInBuf,
DWORD nInBufSize,
PBYTE pOutBuf,
DWORD nOutBufSize,
PDWORD pBytesReturned
);
Parameters
- SmartcardExtension
[in] Points to the smart card structure of the driver.
- pInBuf
[in] Same as the driver entrypoint SCR_IOControl pInBuf parameter.
- nInBufSize
[in] Same as the driver entrypoint SCR_IOControl nInBufSize parameter.
- pOutBuf
[out] Same as the driver entrypoint SCR_IOControl pOutBuf parameter.
- nOutBufSize
[out] Same as the driver entrypoint SCR_IOControl nOutBufSize parameter.
- pBytesReturned
[out] Same as the driver entrypoint SCR_IOControl pBytesReturned parameter.
Return Value
SmartcardDeviceControl returns the NTSTATUS value of the called routine.
Remarks
The driver's XXX_IOControl (Device Manager) routine 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_EXTENSION structure. Before calling SmartcardDeviceControl, the driver must assign to the Version member of SMARTCARD_EXTENSION the value SMCLIB_VERSION. This is usually done in the SCR_Init routine.
Requirements
| Header | smclib.h |
| Windows Embedded CE | Windows CE 3.0 and later |