SmartcardInitialize (WDM) routine

The SmartcardInitialize routine allocates internal buffers for the library.

Syntax

NTSTATUS SmartcardInitialize(
  _In_ PSMARTCARD_EXTENSION SmartcardExtension
);

Parameters

  • SmartcardExtension [in]
    A pointer to a SMARTCARD_EXTENSION structure that contains the device extension of the smart card device.

    • SmartcardExtension->SmartcardRequest.BufferSize
      The value of this member must be set to the number of bytes to allocate for the request buffer. If the value is less than MIN_BUFFER_SIZE, the library allocates MIN_BUFFER_SIZE bytes automatically.

    • SmartcardExtension->SmartcardReceive.BufferSize
      The value of this member must be set to the number of bytes to allocate for the receive buffer. If the value is less than MIN_BUFFER_SIZE, the library allocates MIN_BUFFER_SIZE bytes automatically.

Return value

SmartcardInitialize returns one of the following NTSTATUS values:

Return code Description
STATUS_SUCCESS

The operation succeeded.

STATUS_INSUFFICIENT_RESOURCES

The amount of memory that is required to allocate the buffers is not available.

 

Remarks

The library allocates and uses two internal buffers: SmartcardExtension->SmartcardRequest.Buffer for receiving data, and SmartcardExtension->SmartcardReply.Buffer for sending data. Your driver should call SmartcardInitialize to allocate these buffers, and it should use these buffers to transfer data to and from the smart card. To free these buffers, call SmartcardExit (WDM) from your DriverUnload routine.

The smart card driver library checks the version of the SMARTCARD_EXTENSION structure. Before your driver calls SmartcardInitialize, it must set the Version member of SMARTCARD_EXTENSION to the value SMCLIB_VERSION. This is usually done in the DriverEntry routine.

Requirements

Target platform

Desktop

Version

Available in Windows XP and later versions of Windows.

Header

Smclib.h (include Smclib.h)

Library

Smclib.lib

IRQL

PASSIVE_LEVEL

See also

SmartcardExit (WDM)

SMARTCARD_EXTENSION

 

 

Send comments about this topic to Microsoft