VideoPortStallExecution

VideoPortStallExecution

VOID VideoPortStallExecution(

ULONG Microseconds
);

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

Parameters

Microseconds

Specifies the delay interval, in microseconds.

Comments

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

While a miniport’s HwVidInterrupt or HwVidSynchronizeExecutionCallback function can call VideoPortStallExecution, the miniport 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 have a HwVidTimer function. Calls to a miniport-supplied HwVidTimer function at approximately one-second intervals can be enabled with VideoPortStartTimer and disabled with VideoPortStopTimer.