DXGKDDI_VIDPNTOPOLOGY_CREATENEWPATHINFO callback function (d3dkmddi.h)

The pfnCreateNewPathInfo function returns a pointer to a D3DKMDT_VIDPN_PRESENT_PATH structure that the display miniport driver populates before calling pfnAddPath.

Syntax

DXGKDDI_VIDPNTOPOLOGY_CREATENEWPATHINFO DxgkddiVidpntopologyCreatenewpathinfo;

NTSTATUS DxgkddiVidpntopologyCreatenewpathinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [out] DEREF_OUT_PPD3DKMDT_VIDPN_PRESENT_PATH ppNewVidPnPresentPathInfo
)
{...}

Parameters

[in] hVidPnTopology

A handle to a VidPN topology object. The display miniport driver previously obtained this handle by calling the pfnGetTopology function of the DXGK_VIDPN_INTERFACE interface.

[out] ppNewVidPnPresentPathInfo

A pointer to a variable that receives a pointer to a D3DKMDT_VIDPN_PRESENT_PATH structure allocated by the VidPN manager.

Return value

The pfnCreateNewPathInfo function returns one of the following values:

Return code	Description
STATUS_SUCCESS	The function succeeded.
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY	The handle supplied in hVidPnTopology was invalid.

Remarks

After you call pfnCreateNewPathInfo to obtain a D3DKMDT_VIDPN_PRESENT_PATH structure, you must do one, but not both, of the following:

• Populate the structure and pass it to pfnAddPath.
• Release the structure by calling pfnReleasePathInfo.

The D3DKMDT_HVIDPNTOPOLOGY data type is defined in D3dkmdt.h.

Requirements

Requirement	Value
Target Platform	Desktop
Header	d3dkmddi.h (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL

See also

D3DKMDT_VIDPN_PRESENT_PATH

pfnAddPath

pfnReleasePathInfo