windows-xp/Source/XPSP1/NT/multimedia/media/tools/extract/test/asmcb.txt

@HR = asmFuncWithCallback

This is an imaginary assembler function
to test AUTODOC.  It has an associated callback function.

@HO = Registers

@RNAME = <B>AL<D>

@RDESC = Specifies an 8-bit parameter value.

@RDESC = This is the second paragraph of a register description.

@RNAME = <B>BX<D>

@RDESC = Specifies a 16-bit parameter value.

@RNAME = <B>CL<D>

@RDESC = Specifies an 8-bit parameter value using one of the
following flags:

@RFLAG = RED

@RFLDESC = A flag value.

@RFLAG = WHITE

@RFLDESC = Another flag value.

@RNAME = <B>EDX<D>

@RDESC = Specifies a 32-bit pointer to a callback function.

@LE = 

@HO = Returns

The following registers contain meaningful return values:

@RNAME = <B>CX<D>

@RDESC = This register should come out before the conditionals are
printed.

@FLAG = FOOBAR

@FLDESC = Random flag before the conditionals.

@LE = 

@COND = If AL is zero, the callback was succcessfully installed, and the
following registers contain:

@COND = This is the second paragraph of a conditional.

@RNAME = <B>BX<D>

@RDESC = Specifies a 16-bit return value.

@RNAME = <B>DS:SI<D>

@RDESC = Points to the ASCIIZ name of the callback.

@LE = 

@COND = Otherwise, an error is specified as follows:

@RNAME = <B>AL<D>

@RDESC = Contains one of the following error codes:

@FLAG = ERROR1

@FLDESC = An error.

@FLAG = ERROR2

@FLDESC = Another error.

@LE = 

@LE = 

@HO = Uses

EFLAGS

@LE = 

@HO = Comments

Here are some comments pertaining to this function.  <B>This
sentence should be bold.  <MI>This sentence should be italicized.<D>

This is the second paragraph of comments.  The callback function is
specified as follows:

@HO = Callback

<B>asmCallback<D>

The name <B>asmCallback<D> is a placeholder for
the application-supplied callback function.

@HU = Registers

@RNAME = <B>AL<D>

@RDESC = Specifies an 8-bit parameter value.

@RNAME = <B>BX<D>

@RDESC = Specifies a 16-bit parameter value.

@RNAME = <B>CL<D>

@RDESC = Specifies an 8-bit parameter value using one of the
following flags:

@RFLAG = RED

@RFLDESC = A flag value.

@RFLAG = WHITE

@RFLDESC = Another flag value.

@LE = 

@HU = Returns

The following registers contain meaningful return values:

@RNAME = <B>AL<D>

@RDESC = If zero, the callback was successfully installed.
Otherwise, an error is specified by one of the following flags:

@FLAG = ERROR1

@FLDESC = An error.

@FLAG = ERROR2

@FLDESC = Another error.

@LE = 

@COND = This is an empty conditional to test the code.

None

@LE = 

@COND = Otherwise, the following registers are returned:

@RNAME = <B>BX<D>

@RDESC = Specifies a 16-bit return value.

@LE = 

@LE = 

@HU = Uses

EFLAGS

@LE = 

@HU = Comments

Here are some comments pertaining to the callback function.

@HO = See Also

asmFunc