PVIDEO_HW_INITIALIZE callback function (video.h)

Article
02/22/2024

HwVidInitialize performs the first initialization of the adapter, after the HAL has given up control of the video hardware to the video port driver.

Syntax

PVIDEO_HW_INITIALIZE PvideoHwInitialize;

BOOLEAN PvideoHwInitialize(
  PVOID HwDeviceExtension
)
{...}

Parameters

HwDeviceExtension

Pointer to the miniport driver's per-adapter storage area. For more information, see Device Extensions.

Return value

If the initialization succeeds, HwVidInitialize returns TRUE.

Remarks

Every video miniport driver must have a HwVidInitialize function.

The video port driver calls HwVidInitialize in response to an open request by the corresponding display driver. As soon as HwVidInitialize is called, the miniport driver can change the state of the adapter, unlike the miniport driver's HwVidFindAdapter function, which must leave the adapter in VGA mode. On return from HwVidInitialize, the adapter must be initialized to a state equivalent to that set up by the miniport driver's HwVidResetHw function. This feature is used by autodetection to get mode information from the miniport driver.

If at all possible, HwVidInitialize should avoid programming the device hardware. The miniport driver will initialize the device later, when it is instructed to switch display modes.

HwVidInitialize should be made pageable.

Requirements

Requirement	Value
Target Platform	Desktop
Header	video.h (include Video.h)