VideoPortInt10

VP_STATUS VideoPortInt10(

PVOID  HwDeviceExtension,
PVIDEO_X86_BIOS_ARGUMENTS  BiosArguments
);

VideoPortInt10 performs the equivalent of an MS-DOS INT10 operation, such as setting the video mode. VideoPortInt10 runs the BIOS ROM code on the device.

Parameters

HwDeviceExtension

Points to the miniport driver’s device extension.

BiosArguments

Points to a structure containing values for the x86 registers that should be set before making the BIOS call. The miniport driver should set any unused registers to zero. All values set up in the VIDEO_X86_BIOS_ARGUMENTS structure are interpreted as immediate values.

Return Value

VideoPortInt10 returns NO_ERROR if it successfully called the given BIOS INT10. Otherwise, it returns an error status.

Comments

Usually, VGA-compatible miniport drivers, which support full-screen MS-DOS applications on x86-based machines, call VideoPortInt10. Such a driver’s HwVidFindAdapter function must have set up the VdmPhysicalVideoMemoryAddress and VdmPhysicalVideoMemoryLength for the range in the VIDEO_PORT_CONFIG_INFO structure.

However, other video miniport drivers also can call this function.

Because VideoPortInt10 interprets the BiosArgument parameter values as immediates, the caller cannot pass in or retrieve data from a memory buffer with this function.

See Also

HwVidFindAdapter, VIDEO_PORT_CONFIG_INFO, VIDEO_X86_BIOS_ARGUMENTS, VideoPortGetDeviceBase