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.
Requirements
Requirement | Value |
---|---|
Target Platform | Desktop |
Header | d3dkmddi.h (include D3dkmddi.h) |
IRQL | PASSIVE_LEVEL |