VideoPortStallExecution function

The VideoPortStallExecution function retains control of the processor for the specified number of microseconds and returns to the caller.

Syntax


VOID VideoPortStallExecution(
   ULONG Microseconds
);

Parameters

Microseconds

Specifies the delay interval, in microseconds.

Return value

None

Remarks

Maximum acceptable values for Microseconds are thousands of microseconds during miniport driver initialization. Otherwise, the given delay interval must be no more than 50 microseconds. In general, VideoPortStallExecution can be called only if the miniport driver must wait for a very few microseconds for its adapter to update state.

While a miniport driver's HwVidInterrupt or HwVidSynchronizeExecutionCallback function can call VideoPortStallExecution, the miniport driver should be designed to avoid such a call if at all possible. Delays while running at high hardware priorities adversely affect the overall I/O throughput of the system and can freeze the machine.

If a miniport driver has work to be done at regular intervals of more than 50 microseconds, it should implement the HwVidTimer function. Calls to a miniport driver-supplied HwVidTimer function at approximately one-second intervals can be enabled with VideoPortStartTimer and disabled with VideoPortStopTimer.

Requirements

Target platform

Version

Available in Windows 2000 and later versions of the Windows operating systems.

Header

Video.h (include Video.h)

Library

Videoprt.lib

DLL

Videoprt.sys

IRQL

Any level

See also

HwVidInterrupt
HwVidSynchronizeExecutionCallback
HwVidTimer
VideoPortStartTimer
VideoPortStopTimer

 

 

Send comments about this topic to Microsoft

Show: