2OO1, 15 January
NtReadFile
NtReadFile
NTSYSAPI
NTSTATUS
NTAPI
NtReadFile(
IN HANDLE FileHandle,
IN HANDLE Event OPTIONAL,
IN PIO_APC_ROUTINE ApcRoutine OPTIONAL,
IN PVOID ApcContext OPTIONAL,
OUT PIO_STATUS_BLOCK IoStatusBlock,
OUT PVOID Buffer,
IN ULONG Length,
IN PLARGE_INTEGER ByteOffset OPTIONAL,
IN PULONG Key OPTIONAL );
(Also descripted in Win2000 DDK)
- FileHandle HANDLE to File Object
opened with FILE_READ_DATA access.
- Event Optional HANDLE to Event
Object signaled when reading is done.
- ApcRoutine User defined APC
routine queued for execute after reading is done.
- ApcContext User parameter to
ApcRoutine.
- IoStatusBlock Pointer to IO_STATUS
structure received IO status of file reading.
- Buffer User-allocated buffer for readed
data.
- Length Length of Buffer, in bytes.
- ByteOffset Offset from begining of
file, in bytes.
- Key - ??? (In my opinion: use this, if
you previously lock file, and now you want read it, but without
unlocking).
- Documented by:
- Tomasz Nowak
Requirements:
- Library: ntdll.lib
See also:
-
NtCreateFile
-
NtOpenFile
- NtWriteFile