驅動程式 - Windows NT Driver (Legacy) - 使用範例 - Assembly (MASM32) - Handle StartIO IRP



參考資訊:
https://wasm.in/
http://four-f.narod.ru/
https://github.com/steward-fu/ddk

StartIO提供一個序列化的機制,讓使用者可以依照順序處理IRP,這個機制對於某些只能序列執行的硬體相當有幫助,省去用軟體實現序列化的程式碼,使用步驟如下:

1. IoMarkIrpPending()
2. IoStartNextPacket()

main.asm

.386p
.model flat, stdcall
option casemap:none
    
include c:\masm32\include\w2k\ntstatus.inc
include c:\masm32\include\w2k\ntddk.inc
include c:\masm32\include\w2k\ntoskrnl.inc
include c:\masm32\include\w2k\ntddkbd.inc
include c:\masm32\Macros\Strings.mac

includelib c:\masm32\lib\wxp\i386\ntoskrnl.lib
 
public DriverEntry
 
MyDeviceExtension struct
    szBuffer BYTE 255 dup(?)
    pNextDev PDEVICE_OBJECT ?
MyDeviceExtension ends
 
.code
StartIo proc uses esi edi pMyDevice : PDEVICE_OBJECT, pIrp : PIRP
    local len : dword

    mov eax, pMyDevice
    mov eax, (DEVICE_OBJECT ptr [eax]).DeviceExtension
    lea edi, (MyDeviceExtension ptr [eax]).szBuffer
     
    mov eax, pIrp
    push (_IRP ptr [eax]).AssociatedIrp.SystemBuffer
    pop esi
     
    IoGetCurrentIrpStackLocation pIrp
    movzx eax, (IO_STACK_LOCATION ptr [eax]).MajorFunction
    .if eax == IRP_MJ_WRITE
        invoke DbgPrint, $CTA0("StartIo, IRP_MJ_WRITE")
        IoGetCurrentIrpStackLocation pIrp
        push (IO_STACK_LOCATION ptr [eax]).Parameters.Write._Length
        pop len
         
        invoke memcpy, edi, esi, len
        invoke DbgPrint, $CTA0("Buffer: %s, Length: %d"), edi, len
    .elseif eax == IRP_MJ_READ
        invoke DbgPrint, $CTA0("StartIo, IRP_MJ_READ")

        invoke strcpy, esi, edi
        invoke strlen, edi
        mov len, eax
    .endif
     
    mov eax, pIrp
    mov (_IRP ptr [eax]).IoStatus.Status, STATUS_SUCCESS
    push len
    pop (_IRP ptr [eax]).IoStatus.Information
    fastcall IofCompleteRequest, pIrp, IO_NO_INCREMENT
    invoke IoStartNextPacket, pMyDevice, FALSE
    mov eax, STATUS_SUCCESS
    ret
StartIo endp
 
IrpFile proc pMyDevice : PDEVICE_OBJECT, pIrp : PIRP
    IoGetCurrentIrpStackLocation pIrp
    movzx eax, (IO_STACK_LOCATION ptr [eax]).MajorFunction

    .if (eax == IRP_MJ_CREATE) || (eax == IRP_MJ_CLOSE) 
        .if (eax == IRP_MJ_CREATE)
            invoke DbgPrint, $CTA0("IRP_MJ_CREATE")
        .else
            invoke DbgPrint, $CTA0("IRP_MJ_CLOSE")
        .endif
        mov eax, pIrp
        and (_IRP ptr [eax]).IoStatus.Information, 0
        mov (_IRP ptr [eax]).IoStatus.Status, STATUS_SUCCESS
        fastcall IofCompleteRequest, pIrp, IO_NO_INCREMENT
        mov eax, STATUS_SUCCESS
    .elseif (eax == IRP_MJ_READ) || (eax == IRP_MJ_WRITE)
        IoGetCurrentIrpStackLocation pIrp
        .if (eax == IRP_MJ_READ)
            invoke DbgPrint, $CTA0("IrpFile, IRP_MJ_READ")
        .else
            invoke DbgPrint, $CTA0("IrpFile, IRP_MJ_WRITE")
        .endif
        IoMarkIrpPending pIrp
        invoke IoStartPacket, pMyDevice, pIrp, 0, NULL
        mov eax, STATUS_PENDING
    .endif
    ret
IrpFile endp
 
Unload proc pMyDriver : PDRIVER_OBJECT
    local szSymName : UNICODE_STRING

    invoke RtlInitUnicodeString, addr szSymName, $CTW0("\\DosDevices\\MyDriver")
    invoke IoDeleteSymbolicLink, addr szSymName
                             
    mov eax, pMyDriver
    invoke IoDeleteDevice, (DRIVER_OBJECT ptr [eax]).DeviceObject
    ret
Unload endp
                
DriverEntry proc pMyDriver : PDRIVER_OBJECT, pMyRegistry : PUNICODE_STRING
    local pMyDevice : PDEVICE_OBJECT
    local szDevName : UNICODE_STRING
    local szSymName : UNICODE_STRING

    mov eax, pMyDriver
    mov (DRIVER_OBJECT ptr [eax]).MajorFunction[IRP_MJ_CREATE * (sizeof PVOID)], offset IrpFile
    mov (DRIVER_OBJECT ptr [eax]).MajorFunction[IRP_MJ_CLOSE * (sizeof PVOID)], offset IrpFile
    mov (DRIVER_OBJECT ptr [eax]).MajorFunction[IRP_MJ_WRITE * (sizeof PVOID)], offset IrpFile
    mov (DRIVER_OBJECT ptr [eax]).MajorFunction[IRP_MJ_READ * (sizeof PVOID)], offset IrpFile
    mov (DRIVER_OBJECT ptr [eax]).DriverStartIo, offset StartIo
    mov (DRIVER_OBJECT ptr [eax]).DriverUnload, offset Unload
                    
    invoke RtlInitUnicodeString, addr szDevName, $CTW0("\\Device\\MyDriver")
    invoke RtlInitUnicodeString, addr szSymName, $CTW0("\\DosDevices\\MyDriver")

    invoke IoCreateDevice, pMyDriver, sizeof MyDeviceExtension, addr szDevName, FILE_DEVICE_UNKNOWN, 0, FALSE, addr pMyDevice
    .if eax == STATUS_SUCCESS
        mov eax, pMyDevice
        or (DEVICE_OBJECT ptr [eax]).Flags, DO_BUFFERED_IO
        and (DEVICE_OBJECT ptr [eax]).Flags, not DO_DEVICE_INITIALIZING
        invoke IoCreateSymbolicLink, addr szSymName, addr szDevName
    .endif
    ret
DriverEntry endp
end DriverEntry
.end

app.asm

.386p
.model flat, stdcall
option casemap:none
  
include c:\masm32\include\windows.inc
include c:\masm32\include\masm32.inc
include c:\masm32\include\user32.inc
include c:\masm32\include\msvcrt.inc
include c:\masm32\Macros\Strings.mac
include c:\masm32\include\kernel32.inc
  
includelib c:\masm32\lib\user32.lib
includelib c:\masm32\lib\masm32.lib
includelib c:\masm32\lib\msvcrt.lib
includelib c:\masm32\lib\kernel32.lib
  
.const
MSG_INFO    db "I am error",0
MSG_WRITE   db "WR: %s",10,13,0
MSG_READ    db "RD: %s",10,13,0
MSG_LEN     db "Length: %d",10,13,0
  
.data?
hFile       dd ?
dwRet       dd ?
szBuffer    db 256 dup(?)
  
.code
start:
    invoke CreateFile, $CTA0("\\\\.\\MyDriver"), GENERIC_READ or GENERIC_WRITE, FILE_SHARE_READ, 0, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, 0
    mov hFile, eax
 
    invoke wsprintf, offset szBuffer, offset MSG_INFO
    invoke StrLen, offset szBuffer
    mov dwRet, eax
 
    invoke crt_printf, offset MSG_WRITE, offset szBuffer
    invoke crt_printf, offset MSG_LEN, dwRet
    invoke WriteFile, hFile, offset szBuffer, dwRet, offset dwRet, 0
 
    invoke crt_memset, offset szBuffer, 0, 255
    invoke ReadFile, hFile, offset szBuffer, 255, offset dwRet, 0
    invoke crt_printf, offset MSG_READ, offset szBuffer
    invoke crt_printf, offset MSG_LEN, dwRet
 
    invoke CloseHandle, hFile
    invoke ExitProcess, 0  
end start
end

完成