NdisStallExecution

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This function stalls the caller on the current processor for a given interval.

VOID NdisStallExecution(
IN UINT
MicrosecondsToStall
);

Parameters

MicrosecondsToStall

Specifies the number of microseconds to delay.

Remarks

For the specified MicrosecondsToStall, the caller's thread of execution stalls on the current processor, consuming CPU cycles. When the specified interval expires, the caller resumes execution.

Both NdisMSleepand this function allow a network adapter driver to specify a delay consistently and independently of the clock speed of the host CPU. Neither function involves a timer object used by the NdisMSetTimeror the NdisMSetPeriodicTimerfunction. The resolution of the host system clock varies, so very short delays can take slightly longer than the caller of NdisMSleepor this function specified.

A call to this function prevents any other operating system activity on the current processor and prevents system interrupts from occurring during the stall. Therefore, callers should always specify a stall interval of no longer than 50 microseconds.

Requirements

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	2.0 and later	Ndis.h		Ndislib.lib

Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.