IOCTL_SMARTCARD_POWER - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// winsmcrd.h
// CTL_CODE(0x0031, 0x001, METHOD_BUFFERED, FILE_ANY_ACCESS)
#define IOCTL_SMARTCARD_POWER 0x00310004
View the official Windows Driver Kit DDI referenceNo description available.
Windows may require a driver to have this IOCTL to be NOP and return success.
The IOCTL_SMARTCARD_POWER control code puts the smart card into one of the following power modes:
| Power Mode Setting | Description |
|---|---|
| SCARD_COLD_RESET | Sets virtual power that only affects the IOCTL_SMARTCARD_GET_STATE. No impact on the actual reader power states. Returns SCARD_SPECIFIC in IOCTL_SMARTCARD_GET_STATE if the card is present. |
| SCARD_WARM_RESET | Sets virtual power that only affects the IOCTL_SMARTCARD_GET_STATE. No impact on the actual reader power states. Returns SCARD_SPECIFIC in IOCTL_SMARTCARD_GET_STATE if the card is present. |
(DWORD) that contains the power state to set.
None.
Irp->IoStatus.Status is set to STATUS_SUCCESS if the request is successful. Possible error codes are:
| Return Code | Description |
|---|---|
| STATUS_NO_MEDIA | This code is returned if no smart card is detected. |
| STATUS_INVALID_PARAMETER | This code is returned if the input or output buffer is invalid. |
| STATUS_DEVICE_POWERED_OFF | This code is returned if the proximity radio control is off. |
Virtual power is set to TRUE for COLD_RESET and WARM_RESET; otherwise, virtual power is set to FALSE.
Near field communication (NFC) design guide