Функция NdisScheduleWorkItem (ndis.h)

  • Статья

Примечание NDIS 5. X является нерекомендуемым и заменен NDIS 6. x. Сведения о разработке новых драйверов NDIS см. в статье Сетевые драйверы, начиная с Windows Vista. Сведения о переносе NDIS 5. x драйверы для NDIS 6. x, см. раздел Перенос драйверов NDIS 5.x в NDIS 6.0.

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

Синтаксис

NDIS_STATUS NdisScheduleWorkItem(
  [in] __drv_aliasesMem PNDIS_WORK_ITEM WorkItem
);

Параметры

[in] WorkItem

Указатель на рабочий элемент, настроенный предыдущим вызовом NdisInitializeWorkItem.

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

NdisScheduleWorkItem всегда выполняется успешно и поэтому всегда возвращает NDIS_STATUS_SUCCESS.

Комментарии

Вызов NdisScheduleWorkItem позволяет драйверу NDIS отложить определенную драйвером операцию, которая может или должна быть выполнена на более низком уровне IRQL, чем вызванный IRQL, на котором он в настоящее время выполняется, для функции обратного вызова рабочего потока.

Обратный вызов драйвера выполняется в контексте системного потока в IRQL = PASSIVE_LEVEL позже. Эта функция, предоставляемая вызывающим объектом, отвечает за освобождение хранилища, выделенного драйвером для WorkItem. Например, если драйвер с именем NdisAllocateMemoryWithTag предоставляет область контекста для NdisInitializeWorkItem, его функция обратного вызова должна выполнить обратный вызов NdisFreeMemory с WorkItem , прежде чем она вернет управление.

Драйвер не должен ждать завершения процедуры обратного вызова, если он уже содержит один объект синхронизации и может попытаться получить другой. Например, драйвер NDIS должен освободить все удерживаемые в данный момент блокировки спина и т. д. перед вызовом NdisScheduleWorkItem. Драйвер протокола NDIS самого высокого уровня также должен освободить все имеющиеся в настоящее время семафоры, мьютексы, переменные ресурсов и т. д. перед вызовом NdisScheduleWorkItem. Освобождение всех ресурсов синхронизации перед постановкой в очередь синхронной операции рабочего потока предотвращает взаимоблокировки.

Сериализованный драйвер мини-порта никогда не должен пытаться ставить в очередь подпрограмму обратного вызова рабочего потока, так как такой драйвер не может синхронизировать доступ к областям контекста сетевой карты с обратным вызовом рабочего потока. Следовательно, такой сериализованный драйвер NDIS не может совместно использовать что-либо в области контекста адаптера с функцией обратного вызова рабочего потока, не вызывая периодические сбои системы.

  • Целевая платформа: универсальная
  • Версия: не поддерживается для драйверов NDIS 6.0 в Windows Vista. Вместо этого используйте NdisQueueIoWorkItem. Поддерживается для драйверов NDIS 5.1 в Windows Vista и Windows XP.

Требования

Требование Значение
Заголовок ndis.h (включая Ndis.h)
IRQL IRQL <= DISPATCH_LEVEL

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