Freigeben über


IOCTL_SMARTCARD_POWER IOCTL (winsmcrd.h)

Windows erfordert möglicherweise einen Treiber, dass dieser IOCTL NOP sein und erfolglos ist.

Der IOCTL_SMARTCARD_POWER Steuerelementcode fügt die Smartcard in einen der folgenden Leistungsmodi ein:

Einstellung für den Energiemodus Beschreibung
SCARD_COLD_RESET Legt virtuelle Leistung fest, die sich nur auf die IOCTL_SMARTCARD_GET_STATE auswirkt. Keine Auswirkungen auf die tatsächlichen Leseleistungszustände. Gibt SCARD_SPECIFIC in IOCTL_SMARTCARD_GET_STATE zurück, wenn die Karte vorhanden ist.
SCARD_WARM_RESET Legt virtuelle Leistung fest, die sich nur auf die IOCTL_SMARTCARD_GET_STATE auswirkt. Keine Auswirkungen auf die tatsächlichen Leseleistungszustände. Gibt SCARD_SPECIFIC in IOCTL_SMARTCARD_GET_STATE zurück, wenn die Karte vorhanden ist.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

(DWORD), das den festzulegenden Energiezustand enthält.

Ausgabepuffer

Nichts.

Statusblock

Irp->IoStatus.Status wird auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist. Mögliche Fehlercodes sind:

Rückgabecode Beschreibung
STATUS_NO_MEDIA Dieser Code wird zurückgegeben, wenn keine Smartcard erkannt wird.
STATUS_INVALID_PARAMETER Dieser Code wird zurückgegeben, wenn der Eingabe- oder Ausgabepuffer ungültig ist.
STATUS_DEVICE_POWERED_OFF Dieser Code wird zurückgegeben, wenn das Näherungsfunksteuerelement deaktiviert ist.

Bemerkungen

Virtuelle Leistung wird für COLD_RESET und WARM_RESET auf TRUE festgelegt; andernfalls wird der virtuelle Strom auf FALSE festgelegt.

Anforderungen

Anforderung Wert
Header- winsmcrd.h

Siehe auch

Designleitfaden für Near Field Communication (NFC)

Smartcard-Entwurfshandbuch