This function delays execution of the caller for a specified interval, in microseconds.
| Header file: | Ndis.h |
| Windows CE versions: | 2.0 and later |
VOID NdisMSleep( IN ULONG MicrosecondsToSleep );
For the specified MicrosecondsToSleep, the caller’s thread of execution is put into a wait state, thus allowing other threads to get work done on the current processor. When the specified interval expires, the caller of this function resumes execution.
An NDIS driver should always call this function in preference to the NdisStallExecution function unless the driver is running at IRQL >= DISPATCH_LEVEL. This function can accept a larger delay interval than NdisStallExecution, which should never be called with an interval greater than 50 microseconds.
NIC drivers can call this function from their MiniportInitialize and, possibly, MiniportHalt functions when either function must wait for state changes to occur in the NIC before that function continues its operations.
Both this function and NdisStallExecution allow an NIC 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 NdisSetTimer or the NdisSetPeriodicTimer function. The resolution of the host system clock varies, so very short delays can take slightly longer than the caller of this function or NdisStallExecution specified.
A driver that calls this function runs at IRQL < DISPATCH_LEVEL.
NdisMSetTimer, NdisMSetPeriodicTimer, NdisStallExecution