Microsoft Windows CE 3.0  

RDF_CARD_TRACKING

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

The RDF_CARD_TRACKINGcallback function installs an event handler to track card insertions and removals. This callback function is mandatory.

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

Parameters

SmartcardExtension
Points to the smart card extension of the device.

Return Values

This function returns an NTSTATUS value. Possible values for WDM and VxD device drivers are the following.

Value Meaning
STATUS_PENDING Card tracking has been started.
STATUS_INVALID_DEVICE_STATE The device cannot accept the request.
STATUS_SUCCESS Card status matches the requested tracking call.
STATUS_DEVICE_BUSY A card tracking event is already pending.

Remarks

Before the library calls RDF_CARD_TRACKING, it checks if the status already matches the current card status. (That is, a card is inserted and the caller sends an IOCTL_SMARTCARD_IS_PRESENT code.) In this case, the library returns STATUS_SUCCESS without calling this function.

Otherwise, the driver will be called and it should start card tracking. Usually, the driver returns STATUS_PENDING to this call since the current card status does not match the status to check for. The driver must complete this call as soon as it detects the insertion or removal. This is done by a call to PulseEvent( SmartcardExtension->OsData->hChangeEvent).

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

© 2004 Microsoft Corporation. All rights reserved.