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

Статья
02/26/2024

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

Синтаксис

void NdisMSleep(
  [in] ULONG MicrosecondsToSleep
);

Параметры

[in] MicrosecondsToSleep

Число микросекунд для задержки.

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

None

Remarks

В течение заданного времени в параметре MicrosecondsToSleep поток выполнения вызывающего объекта переводится в состояние ожидания, что позволяет другим потокам выполнять работу на текущем процессоре. По истечении заданного интервала вызывающий объект NdisMSleep возобновляет выполнение.

Драйвер NDIS всегда должен вызывать NdisMSleep в выборе функции NdisStallExecution , если только драйвер не работает в IRQL >= DISPATCH_LEVEL. NdisMSleep может принимать больший интервал задержки, чем NdisStallExecution, который никогда не следует вызывать с интервалом больше 50 микросекунд. Не вызывайте NdisMSleep с временем ожидания более 30 000 000 микросекунд (то есть 30 секунд или полминуты).

Драйверы miniport могут вызывать NdisMSleep из своих функций MiniportInitializeEx и, возможно, MiniportHaltEx , если любая из функций должна ждать изменения состояния в сетевом адаптере, прежде чем эта функция продолжит свою работу.

NdisMSleep и NdisStallExecution позволяют драйверу мини-порта задавать задержку согласованно и независимо от тактовой скорости ЦП узла. Ни функция не включает в себя объект таймера, например объект, используемый функцией NdisSetTimerObject . Разрешение часов системы узла меняется, поэтому очень короткие задержки могут занять немного больше времени, чем время задержки, указанное вызывающим объектом NdisMSleep или NdisStallExecution .

Требования

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