18 февраля 2001
NtCreateIoCompletion (ZwCreateIoCompletion)
NTSYSAPI
NTSTATUS
NTAPI
NtCreateIoCompletion(
OUT PHANDLE IoCompletionHandle,
IN ACCESS_MASK DesiredAccess,
IN POBJECT_ATTRIBUTES ObjectAttributes OPTIONAL,
IN ULONG NumberOfConcurrentThreads );
Функция NtCreateIoCompletion создаёт объект завершения ввода-вывода. Этот объект используется для ожидания текущих незавершённых
операций ввода-вывода (чтения и записи) при доступе к файлу из нескольких процессов.
Он содержит больше информации об операции ввода-вывода, чем событие синхронизации или функция APC.
IoCompletionHandle
Результат вызова - HANDLE вновь созданного объекта завершения ввода-вывода.
DesiredAccess
Маска доступа для созданного HANDLE. Комбинация:
- IO_COMPLETION_QUERY_STATE
- IO_COMPLETION_MODIFY_STATE
- IO_COMPLETION_ALL_ACCESS
ObjectAttributes
Дополнительно содержит имя объекта, в пространстве имён объектов.
NumberOfConcurrentThreads
Количество потоков, получающих доступ к файловому объекту, ассоциированному с объектом завершения ввода-вывода (IO Completion).
Если ноль, система резервирует память для количества потоков, равного текущему количеству запущенных процессов.
Документировал:
Томаш Новак
Reactos
Зависимости:
Библиотека: ntdll.lib
См. также:
FILE_INFORMATION_CLASS
NtOpenIoCompletion
NtQueryIoCompletion
NtRemoveIoCompletion
NtSetInformationFile
NtSetIoCompletion