cCall [ilb.ILB_dprintf_rtn],<<OFFSET32 szFormat>, val1, ...>
Displays information on the debug terminal, providing a subset of the formatting provded by the C-runtime printf function. The function processes the given string, converting format control sequences in the string to characters or numbers, using the corresponding values passed as parameters.
szFormat
Address of a null-terminated string. The string can contain any printable characters and any combination of the following format control sequences:
%b | Displays an 8-bit value as a hexadecimal integer. Must pass a doubleword value with the value to display in the low byte. |
%c | Displays the character at the given address. Must pass a valid, 32-bit address. |
%d | Displays the corresponding 32-bit value as a decimal integer. Must pass a doubleword value. |
%e | Displays the corresponding 32-bit value as a hexadecimal integer. Must pass a doubleword value. |
%i | Displays a 16-bit value as an unsigned decimal integer. Must pass a doubleword value with the value to display in the low word. |
%j | Displays an 8-bit value as a unsigned decimal integer. Must pass a doubleword value with the value to display in the low byte. |
%lx | Displays the 32-bit value at the given address as a hexadecimal integer. Must pass a valid, 32-bit address. |
%p | Displays the given address in 16:16 (segment:offset) notation. Segment and offset values are displayed as hexadecimal integers. |
%s | Displays the null-terminated string at the given address. Must pass a valid, 32-bit address. |
%u | Displays the 16-bit value at the given address as an unsigned decimal integer. Must pass a valid, 32-bit address. |
%w | Displays a 16-bit value as a hexadecimal integer. Must pass a doubleword value with the value to display in the low word. |
%x | Displays the 16-bit value at the given address as a hexadecimal integer. Must pass a valid, 32-bit address. |
%z | Displays a memory dump, consisting of a given number of bytes display as hexadecimal integers. Must pass a 16-bit value specifying the number of bytes to display and a valid, 32-bit address pointing to the bytes to display. |
%% | Displays the percent character (%). |
val1
Value or address, depending on the corresponding format control sequence. Except for the %z format, there must be one 32-bit value passed for each format control sequence in the string. For %z, two 32-bit values must be passed.
See also ILB