{{page>en:templates:dosint}}

====== Int 21H, AH=0AH ======

===== Version =====

1 and higher

===== Brief =====

BUFFERED INPUT

===== Family API =====

[[en:docs:fapi:DosRead]]

===== Input =====

  AH = 0Ah
  DS:DX -> buffer (see #01344)

===== Return =====

  buffer filled with user input

===== Notes =====

 ^C/^Break are checked, and INT 23 is called if either detected reads from standard input, which may be redirected under DOS 2+

 if the maximum buffer size is set to 00h, this call returns immediately without reading any input

Format of DOS input buffer:
^ Offset ^ Size ^   Description ^
| 00h  |  BYTE  | maximum characters buffer can hold |
| 01h  |  BYTE  | (call) number of chars from last input which may be recalled (ret) number of characters actually read, excluding CR |
| 02h | N BYTEs  | actual characters read, including the final carriage return |

===== See also =====

AH=[[en:docs:dos:api:int21:0c|0Ch]],INT 2F/AX=4810h

===== Note =====

Text based on [[http://www.cs.cmu.edu/~ralf/files.html|Ralf Brown Interrupt List Release 61]]

{{page>en:templates:int}}

{{page>en:templates:fapi}}