VideoPortStallExecution function (video.h)

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

Syntax

VIDEOPORT_DEPRECATED VIDEOPORT_API 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

See also

HwVidInterrupt

HwVidSynchronizeExecutionCallback

HwVidTimer

VideoPortStartTimer

VideoPortStopTimer