RDF_CARD_POWER (Windows CE 5.0)
The RDF_CARD_POWER callback function resets or powers down an inserted smart card. This callback function is mandatory.
NTSTATUS (*ReaderFunction[RDF_CARD_POWER])(PSMARTCARD_EXTENSION SmartcardExtension);
Parameters
SmartcardExtension
[in] Points to the smart card extension of the device. SmartcardExtension->MajorIoControlCode must be set to IOCTL_SMARTCARD_POWER. SmartcardExtension->MinorIoControlCode must contain one of the following minor codes, depending on the function to be performed.Minor code Description SCARD_COLD_RESET Performs a cold reset of the card. SCARD_WARM_RESET Performs a warm reset of the card. SCARD_POWER_DOWN Switches off card power. SmartcardExtension->IoRequest.ReplyBufferLength must be set to the length of the reply buffer. When the callback function returns, SmartcardExtension->IoRequest.ReplyBuffer will contain the ATR returned by the card. In addition, you must transfer the ATR to SmartcardExtension->CardCapabilities.ATR.Buffer to let the library parse the ATR*. SmartcardExtension->IoRequest.Information* receives the actual length of the ATR. In addition, you must transfer the length of the ATR to SmartcardExtension->CardCapabilities.ATR.Length.
Return Values
This function returns an NTSTATUS value. Possible values are the following.
| Value | Description |
|---|---|
| STATUS_SUCCESS | Function successfully executed. |
| STATUS_NO_MEDIA | No card is in the reader. |
| STATUS_IO_TIMEOUT | The request has timed out. |
| STATUS_BUFFER_TOO_SMALL | The user buffer is not large enough to hold the ATR. |
Requirements
OS Versions: Windows CE 3.0 and later.
Header: Smclib.h.
See Also
Send Feedback on this topic to the authors