Accessing Files Programmer's Guide (32650-90885)

Chapter 11 147
Accessing a File Using Mapped Access
New Intrinsics
return_ptr 64-bit pointer by reference (required)
The return_ptr is an output parameter that will have the new pointer
value returned to it. It can be a 64-bit pointer to an object of any type
status 32-bit signed integer by reference (optional)
Returns the status of the HPFADDTOPOINTER call. If no errors or warn-
ings 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 condi-
tion, and a positive value indicates a warning condition.
Bits (16:16) comprise status.subsys. The value represents the subsystem
that set the status information.
Operation Notes
No attemt is made to verify that the pointer value returned is a legitimate pointer to a
valid object. Any invalid pointers will be detected and generate errors when the pointers
are dereferenced.
Related Information
Manual Accessing Files Programmer's Guide
HPFFILLDATA
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)