Guardian Procedure Calls Reference Manual

Syntax for C Programmers
#include <cextdecs(FILE_READUPDATE64_)>
short FILE_READUPDATE64_ ( short filenum
,char _ptr64 *buffer
,__int32_t read-count
,[ __int32_t _ptr64 *count-read ]
,[ long long tag ] );
Syntax for TAL Programmers
?SETTOG _64BIT_CALLS
?SOURCE EXTDECS(FILE_READUPDATE64_)
error := FILE_READUPDATE64_ ( filenum ! i
,buffer ! o
,read-count ! i
,[ count-read ] ! o
,[ tag ] ); ! i
Parameters
filenum
input
INT:value
is the number of an open file that identifies the file to be read.
buffer
output
STRING .EXT64:ref:*
is an array where the information read from the file is returned.
read-count
input
INT(32):value
is the number of bytes to be read: {0:4096}.
{0:4096} for disk files
{0:2097152} for $RECEIVE
count-read
output
INT(32) .EXT64:ref:1
for wait I/O only, returns a count of the number of bytes returned from the file into buffer.
tag
input
INT(64):value
for nowait I/O only, is a value you define that uniquely identifies the operation associated
with FILE_READUPDATE64_. If the completed I/O operation has a 32-bit tag, the 64-bit tag is
in the sign-extended value of the 32-bit tag.
FILE_READUPDATE64_ Procedure 487