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


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

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

Синтаксис

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 (include Ndis.h)
библиотеки Ndis.lib
IRQL PASSIVE_LEVEL
правил соответствия DDI Irql_Miscellaneous_Function(ndis)

См. также

DriverEntry драйверов протоколов NDIS

MiniportHaltEx

MiniportInitializeEx

NdisInitializeEvent

NdisResetEvent

NdisSetEvent

ProtocolBindAdapterEx

ProtocolUnbindAdapterEx