SmartcardCompleteRequest (VxD)

The SmartcardCompleteRequest function informs the caller of the completion of a request, unlocks memory, and enables further calls to the smart card library.

VOID 
  SmartcardCompleteRequest(
    IN PSMARTCARD_EXTENSION  SmartcardExtension
    );

Parameters

SmartcardExtension

Pointer to the device extension of the smart card device.

Return Value

None

Headers

Declared in smclib.h. Include smclib.h.

Comments

Use this function to inform the caller and the smart card library that a pending smart card I/O has been finished. If your driver is unable to satisfy a request immediately and one of your callback routines returns STATUS_PENDING, you must call this function at the end of the I/O with the reader. Use the structure member SmartcardExtension->IoRequest when you want to access the caller's memory area. This function automatically unlocks memory that was locked before the callback function was called. The following simplified example illustrates the use of this function

DriverTransmitCallback(
    PSMARTCARD_EXTENSION SmartcardExtension
    )
{
    // Write data to the reader
    WriteDataToReader();

    // The reader will interrupt when data is available
    return STATUS_PENDING;
}

DriverInterrupt(..)
{
    // store incoming data into SmartcardExtension->IoRequest->ReplyBuffer
    ReadDataFromReader();
    
    // Now we’re done with this request and can complete it.
    SmartcardCompleteRequest(SmartcardExtension);
}

This function is not available when developing WDM drivers. For a list of the functions that can be used, see WDM Smart Card Driver Functions.

See Also

SMARTCARD_EXTENSION