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

Подпрограмма 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 в подпрограмму CustomDpc или CustomThreadedDpc объекта DPC.

[in, optional] SystemArgument2

Задает определяемые драйвером контекстные данные. Это значение передается в качестве параметра SystemArgument2 в подпрограмму CustomDpc или CustomThreadedDpc объекта DPC.

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

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

Комментарии

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

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

Требования

См. также раздел

CustomDpc

CustomThreadedDpc

KeInitializeDpc

KeRemoveQueueDpc