Source code of Windows XP (NT5)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

55 lines
2.4 KiB

  1. ;****************************************************************************
  2. ; @doc EXTERNAL TEST
  3. ; @asm asmFuncWithCallback | This is an imaginary assembler function
  4. ; to test AUTODOC. It has an associated callback function.
  5. ; @reg AL | Specifies an 8-bit parameter value.
  6. ;
  7. ; This is the second paragraph of a register description.
  8. ; @reg BX | Specifies a 16-bit parameter value.
  9. ; @reg CL | Specifies an 8-bit parameter value using one of the
  10. ; following flags:
  11. ; @flag RED | A flag value.
  12. ; @flag WHITE | Another flag value.
  13. ; @reg EDX | Specifies a 32-bit pointer to a callback function.
  14. ; @rdesc The following registers contain meaningful return values:
  15. ; @reg CX | This register should come out before the conditionals are
  16. ; printed.
  17. ; @flag FOOBAR | Random flag before the conditionals.
  18. ; @cond If AL is zero, the callback was succcessfully installed, and the
  19. ; following registers contain:
  20. ;
  21. ; This is the second paragraph of a conditional.
  22. ;
  23. ; @reg BX | Specifies a 16-bit return value.
  24. ; @reg DS:SI | Points to the ASCIIZ name of the callback.
  25. ;
  26. ; @cond Otherwise, an error is specified as follows:
  27. ; @reg AL | Contains one of the following error codes:
  28. ; @flag ERROR1 | An error.
  29. ; @flag ERROR2 | Another error.
  30. ; @uses EFLAGS
  31. ; @comm Here are some comments pertaining to this function. <F>This
  32. ; sentence should be bold.<D> <P>This sentence should be italicized.<D>
  33. ;
  34. ; This is the second paragraph of comments. The callback function is
  35. ; specified as follows:
  36. ; @asmcb asmCallback | The name <F>asmCallback<D> is a placeholder for
  37. ; the application-supplied callback function.
  38. ; @reg AL | Specifies an 8-bit parameter value.
  39. ; @reg BX | Specifies a 16-bit parameter value.
  40. ; @reg CL | Specifies an 8-bit parameter value using one of the
  41. ; following flags:
  42. ; @flag RED | A flag value.
  43. ; @flag WHITE | Another flag value.
  44. ; @rdesc The following registers contain meaningful return values:
  45. ; @reg AL | If zero, the callback was successfully installed.
  46. ; Otherwise, an error is specified by one of the following flags:
  47. ; @flag ERROR1 | An error.
  48. ; @flag ERROR2 | Another error.
  49. ; @cond This is an empty conditional to test the code.
  50. ; @cond Otherwise, the following registers are returned:
  51. ; @reg BX | Specifies a 16-bit return value.
  52. ; @uses EFLAGS
  53. ; @comm Here are some comments pertaining to the callback function.
  54. ; @xref asmFunc
  55. ;*****************************************************************************