IOCTL_SMARTCARD_IS_PRESENT IOCTL (winsmcrd.h)
Der IOCTL_SMARTCARD_IS_PRESENT-Steuerelementcode erkennt, ob derzeit eine Smartcard erkannt wird. Wenn eine Karte vorhanden ist, wird sie sofort mit STATUS_SUCCESS zurückgegeben. Wenn keine Smartcard erkannt wird, abonniert sie das Smartcard-Ankunftsereignis und wird ausstehend gehalten. Wenn Sie das Dateihandle schließen, wird das Ereignis abbestellt.
Hauptcode
Eingabepuffer
Nichts.
Ausgabepuffer
Nichts.
Statusblock
Irp->IoStatus.Status wird auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist. Mögliche Fehlercodes sind:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_PENDING | Dieser Code wird zurückgegeben, wenn der Vorgang auf die Smartcard wartet, um in das Funkfeld zu gelangen. |
| STATUS_DEVICE_BUSY | Dieser Code wird zurückgegeben, wenn der Vorgang bereits auf das aktuelle Ereignis wartet. |
| STATUS_INVALID_DEVICE_STATE | Dieser Code wird zurückgegeben, wenn das Gerät die Anforderung nicht annehmen kann. |
| STATUS_INVALID_PARAMETER | Dieser Code wird zurückgegeben, wenn die Eingabe- oder Ausgabepuffer ungültig sind. |
| STATUS_DEVICE_POWERED_OFF | Dieser Code wird zurückgegeben, wenn das Näherungsfunksteuerelement deaktiviert ist. |
Bemerkungen
Die folgenden Aktionen sind erforderlich, wenn Sie diese IOCTL verwenden:
-
Der Treiber muss CancelIo auf diesem pendierten IOCTL unterstützen.
- Es handelt sich um eine energieverwaltete Anforderung. Der stiftete IOCTL behält den Treiber in einem D0-Energiezustand bei.
- Der Treiber muss STATUS_SUCCESS nur für den unterstützten Typ zurückgeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | winsmcrd.h |
Siehe auch
Designleitfaden für Near Field Communication (NFC)