RDF_CARD_POWER

The card power function resets or powers down an inserted smart card.

NTSTATUS 
  (*ReaderFunction[RDF_CARD_POWER])(
    PSMARTCARD_EXTENSION  SmartcardExtension
    );

Parameters

SmartcardExtension

Pointer to the smart card extension of the device. On input, the structure pointed to by SmartcardExtension should have the following values:

• The MajorIoControlCode member should have a value of IOCTL_SMARTCARD_POWER.
• The IoRequest.ReplyBufferLength member should contain the length of the buffer.
• The MinorIoControlCode member should have one of the following minor codes:

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.

On output, SmartcardExtension should have the following values.

Member of SmartcardExtension	Meaning
IoRequest.ReplyBuffer	This buffer receives 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.
IoRequest.Information	Receives the actual length of the ATR.
CardCapabilities.ATR.Length	Contains the length of the ATR.

Return Value

This function returns an NTSTATUS value. Possible values are the following.

Headers

Declared in smclib.h. Include smclib.h.

Comments

It is mandatory for card reader drivers to implement this callback function.

See Also

SMARTCARD_EXTENSION