Недокументированные функции NTDLL

14 февраля 2001



NtWriteFileGather (ZwWriteFileGather)

NTSYSAPI 
NTSTATUS
NTAPI

NtWriteFileGather(


  IN HANDLE               FileHandle,
  IN HANDLE               Event OPTIONAL,
  IN PIO_APC_ROUTINE      ApcRoutine OPTIONAL,
  IN PVOID                ApcContext OPTIONAL,
  OUT PIO_STATUS_BLOCK    IoStatusBlock,
  IN FILE_SEGMENT_ELEMENT SegmentArray,
  IN ULONG                Length,
  IN PLARGE_INTEGER       ByteOffset,
  IN PULONG               Key OPTIONAL );



Функция NtWriteFileGather пишет в заданный блок в файле данные из страниц памяти. См. описание функции NtReadFileScatter.


  • FileHandle
    •     HANDLE файла, открытый с доступом FILE_WRITE_DATA и опцией открытия FILE_NO_INTERMEDIATE_BUFFERING.
        Внимание: Нельзя использовать файл, открытый с доступом FILE_APPEND_DATA.
  • Event
    •     HANDLE события, которое переходит в сигнальное состояние после того, как состоялась запись. Функция использует асинхронный режим записи, поэтому следует использовать параметры Event или ApcRoutine.
  • ApcRoutine
    •     Указатель на функцию APC.
  • ApcContext
    •     Параметр для ApcRoutine.
  • IoStatusBlock
    •     Результат ввода-вывода.
  • SegmentArray
    •     Массив элементов FILE_SEGMENT_ELEMENT, указывающих на страницы памяти, в которые нужно записать. Последний элемент массива должен быть NULL.
  • Length
    •     Количество байт для записи.
  • ByteOffset
    •     Указатель на LARGE_INTEGER, стартовая позиция записи.
  • Key
    •     Дополнительный указатель на пользовательский ключ, который используется, если файл залочен (см. NtLockFile).


    Документировал:
    Томаш Новак



    Зависимости:
    Библиотека: ntdll.lib


    См. также:
    NtCreateFile
    NtLockFile
    NtOpenFile
    NtReadFileScatter
    NtWriteFile