RDF_CARD_POWER
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
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 Meaning 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 | Meaning |
|---|---|
| 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
| 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
© 1992-2000 Microsoft Corporation. All rights reserved.