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

Статья
02/29/2024

Функция NdisWaitEvent переводит вызывающий объект в состояние ожидания до тех пор, пока данное событие не будет установлено в состояние Signaled или не истекло время ожидания.

Синтаксис

BOOLEAN NdisWaitEvent(
  [in] PNDIS_EVENT Event,
  [in] UINT        MsToWait
);

Параметры

[in] Event

Указатель на инициализированный объект события, для которого вызывающий объект предоставляет хранилище.

[in] MsToWait

Количество миллисекундах, которое будет ожидать вызывающий объект, если для события не задано состояние сигнала в течение этого интервала. Нулевое значение указывает, что вызывающий объект будет ждать события бесконечно.

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

NdisWaitEvent возвращает значение TRUE , если событие находится в состоянии сигнала при выполнении ожидания.

NdisWaitEvent возвращает управление вызывающему объекту, когда подается сигнал о заданном событии или истекает указанный интервал MsToWait , в зависимости от того, что наступит раньше. Если событие в настоящее время находится в состоянии сигнала при этом вызове, NdisWaitEvent немедленно возвращает управление.

Драйвер мини-порта обычно вызывает NdisWaitEvent из своих функций MiniportInitializeEx и MiniportHaltEx . Драйвер протокола обычно вызывает NdisWaitEvent из его ProtocolBindAdapterEx и Функции ProtocolUnbindAdapterEx .

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается для драйверов NDIS 6.0 и NDIS 5.1 (см. раздел NdisWaitEvent (NDIS 5.1)) в Windows Vista. Поддерживается для драйверов NDIS 5.1 (см. раздел NdisWaitEvent (NDIS 5.1)) в Windows XP.
Целевая платформа	Универсальное
Верхняя часть	ndis.h (включая Ndis.h)
Библиотека	Ndis.lib
IRQL	PASSIVE_LEVEL
Правила соответствия DDI	Irql_Miscellaneous_Function(ndis)