SmartcardAcquireRemoveLock (WDM) routine
The SmartcardAcquireRemoveLock routine increments a counter of references to the driver.
Syntax
NTSTATUS SmartcardAcquireRemoveLock(
_In_ PSMARTCARD_EXTENSION SmartcardExtension
);
Parameters
- SmartcardExtension [in]
A pointer to a SMARTCARD_EXTENSION structure that contains the device extension for the smart card device which, in turn, contains the reference counter to increment.
Return value
SmartcardAcquireRemoveLock returns one of the following NTSTATUS values:
| Return code | Description |
|---|---|
| STATUS_SUCCESS | The lock was obtained successfully. |
| STATUS_DELETE_PENDING | The driver is about to unload. |
Remarks
If the driver is about to unload, no additional code should be executed (in other words, SmartcardAcquireRemoveLock should return immediately).
SmartcardAcquireRemoveLock should be called whenever an entry-point routine to the driver is called (for example, whenever the device I/O control routine is called). SmartcardAcquireRemoveLock makes sure that the driver does not unload while other driver code is being executed.
Requirements
Target platform |
Desktop |
Version |
Available in Windows XP and later versions of Windows. |
Header |
Smclib.h (include Smclib.h) |
Library |
Smclib.lib |
IRQL |
<= DISPATCH_LEVEL |
See also