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.