Функция NdisWaitEvent (ndis.h)
Функция 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) |