Skip to content

Latest commit

 

History

History
74 lines (56 loc) · 2.88 KB

nc-dispmprt-dxgkddi_exchangeprestartinfo.md

File metadata and controls

74 lines (56 loc) · 2.88 KB
Raw
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NC:dispmprt.DXGKDDI_EXCHANGEPRESTARTINFO
DXGKDDI_EXCHANGEPRESTARTINFO (dispmprt.h)
Allows very simple data to be exchanged between the OS and driver which may be required prior to DxgkDdiStartDevice device being called and therefore cannot be queried through normal caps or adapter info DDIs.
display\dxgkddi_exchangeprestartinfo.htm
display
04/16/2018
DXGKDDI_EXCHANGEPRESTARTINFO callback function
DXGKDDI_EXCHANGEPRESTARTINFO, DXGKDDI_EXCHANGEPRESTARTINFO callback, DXGKDDI_EXCHANGEPRESTARTINFO callback function [Display Devices], display.dxgkddi_exchangeprestartinfo, dispmprt/DXGKDDI_EXCHANGEPRESTARTINFO
dispmprt.h
Windows
Windows
DXGKDDI_EXCHANGEPRESTARTINFO
dispmprt/DXGKDDI_EXCHANGEPRESTARTINFO
APIRef
kbSyntax
UserDefined
dispmprt.h
DXGKDDI_EXCHANGEPRESTARTINFO

DXGKDDI_EXCHANGEPRESTARTINFO callback function

-description

Allows very simple data to be exchanged between the OS and driver which may be required prior to DxgkDdiStartDevice device being called and therefore cannot be queried through normal caps or adapter info DDIs.

-parameters

-param hAdapter [in]

Identifies the adapter.

-param pPreStartInfo [in]

Pointer to a DXGK_PRE_START_INFO structure, which contains both fields for the OS to pass info and fields for the driver to return info. Initially, only SupportPreserveBootDisplay is defined.

[out] SupportPreserveBootDisplay

The driver and hardware support the requirements that allow the boot frame buffer to be used and displayed throughout the hardware initialization, performed during DxgkDdiStartDevice.

-returns

If this routine succeeds and returns the requested change, it returns STATUS_SUCCESS.

-remarks

This DDI will be called after DxgkDdiAddDevice and before DxgkDdiStartDevice so that the driver does not have access to its own hardware resources. However, it can use the PhysicalDeviceObject passed to the driver in DxgkDdiAddDevice to call IoGetDeviceProperty. For example, it can find the hardware id in order to decide what to return in the output fields of the DXGK_PRE_START_INFO structure.

This function is always called at PASSIVE level so the supporting code should be made pageable where possible.