PVIDEO_HW_INITIALIZE - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// video.h

PVIDEO_HW_INITIALIZE PvideoHwInitialize;

BOOLEAN PvideoHwInitialize(
  PVOID HwDeviceExtension
)
{...}
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nc-video-pvideo_hw_initialize)

PVIDEO_HW_INITIALIZE callback function

Description

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

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.

See also

DrvAssertMode

HwVidFindAdapter

HwVidResetHw