|
|
NM callable only.
This routine can be used to efficiently initialize a buffer with a specified
character value.
Syntax
I64 @64 CV I32
HPFFILLDATA (count, buffer_ptr, fill_char, status);
Parameters
- count
64-bit signed integer by reference (required)
A positive count of the number of bytes in the buffer indicated by the
buffer_ptr parameter that should be initialized.
- buffer_ptr
64-bit pointer by value (required)
A pointer to the buffer that should be initialized. The buffer_ptr may
point to any valid object in your stack, heap, or a file that has been
opened with user mapped access.
- fill_char
Character value by value (required)
The character value that should be used to initialize the specified
buffer. Any value in the range of 0 through 255 can be specified,
including all printable and non-printable ASCII characters.
- status
32-bit signed integer by reference (optional)
Returns the status of the HPFFILLDATA call. If no errors or warnings are
encountered, status returns 32 bits of zero. If errors or warnings are
encountered, status is interpretted as two 16-bit fields. Bits
(0:16) comprise status.info. A negative value indicates an error
condition, and a positive value indicates a warning condition.Bits
(16:16) comprise status.subsys. The value represents the subsystem that
set the status information.
Related Information
|