home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / magazine / msysjour / ms / s12349 / test.asm < prev    next >
Assembly Source File  |  1989-06-06  |  8KB  |  253 lines
  1.         PAGE    ,132
  2.         TITLE   Test Device Driver
  3.         SUBTTL  MAIN MODULE
  4. .286P                   ; Enable 80286 protect-mode instructions
  5.  
  6.  
  7.         INCLUDE SAMPDEFS.INC                    ; which includes some other .incs
  8.  
  9. MAIN_DATA       SEGMENT WORD PUBLIC 'DATA'
  10.  
  11. MAIN_DATA       ENDS
  12.  
  13.  
  14. MAIN_CODE       SEGMENT WORD PUBLIC 'CODE'
  15.  
  16. MAIN_CODE       ENDS
  17.  
  18.  
  19. HIGH_DATA       SEGMENT WORD PUBLIC 'FAR_DATA'
  20.  
  21. HIGH_DATA       ENDS
  22.  
  23.  
  24. HIGH_CODE       SEGMENT WORD PUBLIC 'FAR_CODE'
  25.  
  26. extrn  HighTimer:FAR
  27.  
  28. HIGH_CODE       ENDS
  29.  
  30. MAIN_DATA SEGMENT WORD PUBLIC 'DATA'
  31.          ASSUME CS:MAIN_CODE,DS:MAIN_DATA,ES:NOTHING,SS:NOTHING
  32.  
  33. ;====================================================
  34. ;
  35. ; Device Header -
  36. ;
  37. ;====================================================
  38.  
  39. IFDEF DEBUG
  40.         PUBLIC  SAMP_DEV
  41. ENDIF
  42.  
  43. SAMP_DEV LABEL WORD
  44.         DW      -1,-1                               ; SYSINIT handles the segment part
  45.         DW      DEV_CHAR_DEV OR DEVLEV_1 OR DEV_30 OR DEV_GIOCTL
  46.                                                     ; Use equates in DEVHDR.INC
  47.                                                     ; to define Attribute word
  48.         DW      OFFSET MAIN_CODE:STRAT              ; offset to strategy routine
  49.                                                     ; entry point
  50.         DW      0                                   ; Reserved
  51.         DB      'TEST$   '                          ; Name of device
  52. DPS     DB      8 DUP (?)                           ; More reserved
  53.  
  54. ; End of the device header.
  55. ; 
  56. ;============================================================================
  57.  
  58. ;
  59. ;  data structure used by this device driver
  60. ;
  61.  
  62.         EVEN
  63. DISPTAB LABEL WORD
  64.  
  65.         DW      OFFSET MAIN_CODE:SAMP_INIT       ;0: Init
  66.         DW      OFFSET MAIN_CODE:SAMP_EXIT       ;1: Media Check (Block Devices Only)
  67.         DW      OFFSET MAIN_CODE:SAMP_EXIT       ;2: Build BPB (Block Devices Only)
  68.         DW      OFFSET MAIN_CODE:SAMP_EXIT       ;3: Reserved (used to be Ioctl Input)
  69.         DW      OFFSET MAIN_CODE:SAMP_EXIT       ;4: Input (Read)
  70.         DW      OFFSET MAIN_CODE:SAMP_EXIT       ;5: Non-Destructive Input, no wait.
  71.         DW      OFFSET MAIN_CODE:SAMP_EXIT       ;6: Input Status
  72.         DW      OFFSET MAIN_CODE:SAMP_EXIT       ;7: Input Flush
  73.         DW      OFFSET MAIN_CODE:SAMP_EXIT       ;8: Output (Write)
  74.         DW      OFFSET MAIN_CODE:SAMP_EXIT       ;9: Output (Write) with verify
  75.         DW      OFFSET MAIN_CODE:SAMP_EXIT       ;10: Output Status
  76.         DW      OFFSET MAIN_CODE:SAMP_EXIT       ;11: Output Flush
  77.         DW      OFFSET MAIN_CODE:SAMP_EXIT       ;12: Reserved (used to be Ioctl Output)
  78.         DW      OFFSET MAIN_CODE:SAMP_EXIT       ;13: Device Open
  79.         DW      OFFSET MAIN_CODE:SAMP_EXIT       ;14: Device Close
  80.         DW      OFFSET MAIN_CODE:SAMP_EXIT       ;15: Removable Media
  81.         DW      OFFSET MAIN_CODE:SAMP_EXIT       ;16: Generic Ioctl
  82.         DW      OFFSET MAIN_CODE:SAMP_EXIT       ;17: Reset Media
  83.         DW      OFFSET MAIN_CODE:SAMP_EXIT       ;18: Get Logical Drive Map
  84.         DW      OFFSET MAIN_CODE:SAMP_EXIT       ;19: Set Logical Drive Map
  85.         DW      OFFSET MAIN_CODE:SAMP_EXIT       ;20: DeInstall
  86.  
  87. MAXCMD = (($ - DispTab)/2) - 1
  88.  
  89. DevHlp        DD   0
  90. HighDS        DW   SEG HIGH_DATA
  91.  
  92. PUBLIC        DevHlp
  93.  
  94. MAIN_DATA       ENDS
  95.  
  96.  
  97. page
  98.  
  99.  
  100. MAIN_CODE       SEGMENT WORD PUBLIC 'CODE'
  101.          ASSUME CS:MAIN_CODE,DS:MAIN_DATA,ES:NOTHING,SS:NOTHING
  102.  
  103. ;============================================================================
  104. ;
  105. ; - SAMP_STRAT -
  106. ;
  107. ;       Device Driver strategy entry point.
  108. ;       Parameters      - es:bx = Pointer to the request block
  109. ;
  110.  
  111. STRAT       PROC    FAR
  112.         ASSUME  DS:MAIN_DATA
  113.  
  114. IFDEF      DEBUG
  115.                INT     3
  116. ENDIF
  117.  
  118.         SUB     SP,SIZE LOCALDATA               ; reserve space for LocalData (Defined in .INC file)
  119.         MOV     BP,SP                           ; ...referenced with positive offsets
  120.         MOV     [BP].LD_PTRSAVE._OFF,BX         ; Save the virtual address  (ES:BX)
  121.         MOV     [BP].LD_PTRSAVE._SEG,ES         ; ...of the Request Packet.
  122.         MOV     AL,ES:[BX].PKTCMD               ; Get command from packet
  123.         CBW
  124.         CMP     AL,MAXCMD                       ; Make sure its allowed
  125.         JA      SAMPEXIT1                        ; Jump to exit if bad command.
  126.  
  127.         ADD     AX,AX                           ; Convert to table index
  128.                                                 ; (Word sized instead of byte sized)
  129.  
  130.         MOV     BX,AX                           ; Move to BX and...
  131.         JMP     DISPTAB[BX]                     ;Go execute command
  132.  
  133. ;
  134. ; On entry to each of the command handlers:
  135. ;
  136. ;       DS                 = Driver data
  137. ;       SS:BP              = LocalData structure
  138. ;       SS:[BP].LD_PTRSAVE = Far pointer to the request block, which looks like:
  139. ;
  140. ;               13-BYTE request header
  141. ;                   BYTE    length of packet in bytes
  142. ;                   BYTE    subunit number of BLOCK device (unused by char dev.)
  143. ;                   BYTE    command code
  144. ;                   WORD    status word (returned by DD)
  145. ;                   DWORD   reserved
  146. ;                   DWORD   request queue link
  147. ;               n WORDS command specific data
  148. ;
  149.  
  150. STRAT       ENDP
  151.  
  152. page
  153. ;============================================================================
  154. ;
  155. ; - SAMP_EXIT - All routines return through this path
  156. ;
  157. ; On transfer to a label within SAMPExit:
  158. ;       ss:bp              = LocalData structure
  159. ;       ss:[bp].ld_ptrsave = Far pointer to the request block
  160. ;
  161. ;   Notice that the stack doesn't have to be balanced when you get to here.
  162. ; You can be down 6 pushes deep, and jump to here, just so long as SS:BP
  163. ; points to the LocalData structure.  SP will be set from BP.
  164. ;============================================================================
  165.  
  166.  
  167.         PUBLIC  SAMP_EXIT,SAMPEXIT0,SAMPEXIT1,SAMPEXIT9
  168.  
  169. SAMP_EXIT PROC FAR
  170.     ASSUME DS:MAIN_DATA
  171.  
  172. SAMPEXIT0:                                      ;0100h Done, no error
  173.         MOV     AX,STDON
  174.         JMP     SHORT  FINAL_EXIT
  175.  
  176. SAMPEXIT1:                                      ;8103h Done, error = "unknown command"
  177.  
  178.  
  179. SAMPEXIT9:                                      ;810Ch Done, error = "general failure"
  180.  
  181.         MOV     AX,STDON+STERR+ERROR_I24_GEN_FAILURE
  182.  
  183. ; 
  184. ; All exits come to this point before returning.
  185. ;
  186. FINAL_EXIT:
  187.  
  188.         LDS     BX,[BP].LD_PTRSAVE              ;Load packet address back into DS:BX
  189.         MOV     [BX].PKTSTATUS,AX               ;Mark operation complete
  190.  
  191.         MOV     SP,BP                           ;Re-Load SP form BP (clean up stack)
  192.         ADD     SP,SIZE LOCALDATA               ;And de-allocate local data space
  193.  
  194.  
  195.         RET
  196. SAMP_EXIT ENDP
  197.  
  198.  
  199. ;==============================================================================
  200. ;
  201. ;
  202. ;
  203. ;  Timer Handler
  204. ;
  205. ;
  206. ;
  207. ;==============================================================================
  208.  
  209.  
  210. TimerHandler   PROC    FAR
  211.                PUBLIC  TimerHandler
  212.  
  213.     pusha                                         ;
  214.     push    ds
  215.     mov     ds, HighDS                            ; DS -> extra data segment
  216.  
  217.     call    HighTimer                             ; HighTimer is in extra code
  218.  
  219.     pop     ds                                    ; segment (test_hi.asm)
  220.  
  221.     popa
  222.     ret
  223.  
  224. TimerHandler   ENDP
  225.  
  226.  
  227. ;==============================================================================
  228. ;
  229. ;
  230. ;
  231. ;  SAMP_INIT
  232. ;
  233. ;
  234. ;
  235. ;==============================================================================
  236.  
  237. IFDEF DEBUG
  238.         PUBLIC  SAMP_INIT
  239. ENDIF
  240.  
  241.  
  242. SAMP_INIT PROC NEAR
  243.         ASSUME  DS:MAIN_DATA
  244.  
  245. extrn   Do_Init:near
  246.         jmp    Do_Init         ; A routine in test_i.asm
  247.  
  248. SAMP_INIT        ENDP
  249.  
  250.  
  251. MAIN_CODE       ENDS
  252.                 END
  253.