Функция IoAllocateWorkItem (wdm.h)

Статья
03/01/2024

Подпрограмма IoAllocateWorkItem выделяет рабочий элемент.

Синтаксис

PIO_WORKITEM IoAllocateWorkItem(
  [in] PDEVICE_OBJECT DeviceObject
);

Параметры

[in] DeviceObject

Указатель на объект драйвера вызывающего объекта или на один из объектов устройства вызывающего объекта. Если позже вызывающий объект передаст рабочий элемент в IoQueueWorkItem, DeviceObject должен указывать на объект устройства.

Возвращаемое значение

IoAllocateWorkItem возвращает указатель на выделенную IO_WORKITEM структуру. Подпрограмма возвращает значение NULL , если не существует достаточного количества ресурсов.

IoAllocateWorkItem выделяет и инициализирует рабочий элемент. Связанная подпрограмма IoInitializeWorkItem инициализирует рабочий элемент в хранилище, которое ранее выделил драйвер. Не вызывайте IoInitializeWorkItem для инициализации рабочего элемента, выделенного IoAllocateWorkItem.

Дополнительные сведения о рабочих элементах см. в разделе Системные рабочие потоки.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows 2000 и более поздних версиях операционной системы Windows, а также в Windows Me. Эта подпрограмма недоступна в Windows 98.
Целевая платформа	Универсальное
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL