WDM Okuyucu Sürücüsü

Required routines

WDM okuyucu sürücüsü için aşağıdaki yordamlar gereklidir.

DriverEntry

Sürücü nesnesini ve dağıtım tablosunu başlatır.

AddDevice

Akıllı kart okuyucu için bir cihaz nesnesi oluşturur. In addition, AddDevice can call any of the following driver library routines:

• SmartcardInitialize (WDM) to complete driver initialization. Calling this routine in AddDevice is obligatory.
• SmartcardLogError (WDM) to log an error. Drivers must call this routine in AddDevice if SmartcardInitialize (WDM) fails.
• SmartcardCreateLink (WDM) to create a symbolic link for the reader device in the registry.

Unload

Sürücüyü sistemden kaldırır.

DispatchCreate

-and-

DispatchClose

Supports IRP_MJ_CREATE and IRP_MJ_CLOSE<, respectively. To establish a connection to the reader, the resource manager sends IRP_MJ_CREATE to the reader driver. To sever the connection, the resource manager sends IRP_MJ_CLOSE.

DispatchCleanup

Supports IRP_MJ_CLEANUP, which the resource manager sends to the reader driver to cancel pending I/O requests.

DispatchPnP

Supports IRP_MJ_PNP

DispatchPower

Supports IRP_MJ_POWER.

DispatchDeviceControl

Supports IRP_MJ_DEVICE_CONTROL and is the main entry point for smart card requests. Upon receiving IRP_MJ_DEVICE_CONTROL, DispatchDeviceControl must immediately call SmartcardDeviceControl (WDM), which is the smart card driver library routine that handles device-control requests. Aşağıdaki kod örneğinde bu kitaplık yordamının bir WDM sürücüsünden nasıl çağrılması gösterilmektedir:

NTSTATUS
DriverDeviceControl(
    PDEVICE_OBJECT DeviceObject,
    PIRP Irp
    )
{
    PDEVICE_EXTENSION deviceExtension = DeviceObject -> DeviceExtension;

    return SmartcardDeviceControl(
        &(deviceExtension->SmartcardExtension),
        Irp
        );

If it is unable to handle the particular IOCTL that is indicated in the call, SmartcardDeviceControl will call the driver's callback for unknown IOCTL requests.