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

Статья
02/07/2025

KeInsertQueueDpc подпрограммы очереди DPC для выполнения.

Синтаксис

BOOLEAN KeInsertQueueDpc(
  [in, out]      PRKDPC                 Dpc,
  [in, optional] PVOID                  SystemArgument1,
  [in, optional] __drv_aliasesMem PVOID SystemArgument2
);

Параметры

[in, out] Dpc

Указатель на структуру KDPC для объекта DPC. Эта структура должна быть инициализирована KeInitializeDpc или KeInitializeThreadedDpc.

[in, optional] SystemArgument1

Указывает данные контекста, определяемые драйвером. Это значение передается в качестве параметра SystemArgument1объекта DPC или CustomThreadedDpc.

[in, optional] SystemArgument2

Указывает данные контекста, определяемые драйвером. Это значение передается в качестве параметра SystemArgument2объекта DPC или customThreadedDpc.

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

Если указанный объект DPC в настоящее время не находится в очереди DPC, KeInsertQueueDpc очереди DPC и возвращает TRUE.

Замечания

Если указанный объект DPC уже был в очереди, операция не выполняется, кроме возврата FALSE. В противном случае объект DPC вставляется в очередь DPC. Дополнительные сведения о очередях DPC см. в организации очередей DPC.

Обратите внимание, что определенный объект DPC и функция, представляющая ее, может быть помещена в очередь только один раз в определенное время.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 2000.
целевая платформа	Всеобщий
заголовка	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Любой уровень
правил соответствия DDI	HwStorPortProhibitedDIs(storport), MarkingQueuedIrps(wdm)

См. также

Поделиться через