en:docs:dos:api:int21:59

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
en:docs:dos:api:int21:59 [2024/05/03 06:02] – prokusheven:docs:dos:api:int21:59 [2025/07/13 12:56] (current) – prokushev
Line 13: Line 13:
 ===== Family API ===== ===== Family API =====
  
 +[[en:docs:fapi:DosErrClass]]
  
 ===== Input ===== ===== Input =====
  
- AH = 59h +  * AH = 59h 
- BX = 0000h+  * BX = 0000h
  
 ===== Return ===== ===== Return =====
  
-        AX = extended error code (see #01680) +  * AX = extended error code (see #01680) 
- BH = error class (see #01682) +  * BH = error class (see #01682) 
- BL = recommended action (see #01683) +  * BL = recommended action (see #01683) 
- CH = error locus (see #01684) +  * CH = error locus (see #01684) 
- ES:DI may be pointer (see #01681, #01680) +  * ES:DI may be pointer (see #01681, #01680) 
- CL, DX, SI, BP, and DS destroyed+  * CL, DX, SI, BP, and DS destroyed
  
 ===== Notes ===== ===== Notes =====
Line 265: Line 266:
  
 Format of media ID structure: Format of media ID structure:
-Offset Size Description (Table 01681) + 
- 00h 12 BYTEs ASCIZ volume label of required disk +^ Offset ^ Size ^ Description ^ 
- 0Ch DWORD serial number (DOS 4.0+)+| 00h | 12 BYTEs | ASCIZ volume label of required disk | 
 +| 0Ch | DWORD | serial number (DOS 4.0+) | 
 SeeAlso: #01680 SeeAlso: #01680
  
-(Table 01682)+
 Values for DOS Error Class: Values for DOS Error Class:
- 01h (1)  out of resource (storage space or I/O channels) +| 01h (1) | out of resource (storage space or I/O channels) | 
- 02h (2)  temporary situation (file or record lock) +| 02h (2) | temporary situation (file or record lock) | 
- 03h (3)  authorization / permission problem (denied access) +| 03h (3) | authorization / permission problem (denied access) | 
- 04h (4)  internal system error (system software bug) +| 04h (4) | internal system error (system software bug) | 
- 05h (5)  hardware failure +| 05h (5) | hardware failure | 
- 06h (6)  system failure (configuration file missing or incorrect) +| 06h (6) | system failure (configuration file missing or incorrect) | 
- 07h (7)  application program error +| 07h (7) | application program error | 
- 08h (8)  not found +| 08h (8) | not found | 
- 09h (9)  bad format +| 09h (9) | bad format | 
- 0Ah (10) locked +| 0Ah (10) | locked | 
- 0Bh (11) media error +| 0Bh (11) | media error | 
- 0Ch (12) already exists / collision with existing item +| 0Ch (12) | already exists / collision with existing item | 
- 0Dh (13) unknown / other +| 0Dh (13) | unknown / other | 
- 0Eh (14) (undoc) cannot +| 0Eh (14) | (undoc) cannot | 
- 0Fh (15) (undoc) time+| 0Fh (15) | (undoc) time |
 SeeAlso: #01680,#01683,#01684 SeeAlso: #01680,#01683,#01684
  
 (Table 01683) (Table 01683)
 Values for DOS Suggested Action: Values for DOS Suggested Action:
- 01h retry +| 01h | retry | 
- 02h delayed retry (after pause) +| 02h | delayed retry (after pause) | 
- 03h prompt user to reenter input +| 03h | prompt user to reenter input | 
- 04h abort after cleanup +| 04h | abort after cleanup | 
- 05h immediate abort ("panic") +| 05h | immediate abort ("panic") | 
- 06h ignore +| 06h | ignore | 
- 07h retry after user intervention+| 07h | retry after user intervention |
 SeeAlso: #01680,#01682,#01684 SeeAlso: #01680,#01682,#01684
  
-(Table 01684)+
 Values for DOS Error Locus: Values for DOS Error Locus:
- 01h unknown or not appropriate +| 01h | unknown or not appropriate | 
- 02h block device (disk error) +| 02h | block device (disk error) | 
- 03h network related +| 03h | network related | 
- 04h serial device (timeout) +| 04h | serial device (timeout) | 
- 04h (PTS-DOS 6.51+ & S/DOS 1.0+) character device +| 04h | (PTS-DOS 6.51+ & S/DOS 1.0+) character device | 
- 05h memory related+| 05h | memory related |