DXGKDDI_VIDPNTOPOLOGY_ACQUIRENEXTPATHINFO - NtDoc

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

DXGKDDI_VIDPNTOPOLOGY_ACQUIRENEXTPATHINFO DxgkddiVidpntopologyAcquirenextpathinfo;

NTSTATUS DxgkddiVidpntopologyAcquirenextpathinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in]  IN_CONST_PD3DKMDT_VIDPN_PRESENT_PATH_CONST pVidPnPresentPathInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppNextVidPnPresentPathInfo
)
{...}
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Edit description on GitHub

Windows Driver Kit DDI reference (nc-d3dkmddi-dxgkddi_vidpntopology_acquirenextpathinfo)

DXGKDDI_VIDPNTOPOLOGY_ACQUIRENEXTPATHINFO callback function

Description

The pfnAcquireNextPathInfo function returns a descriptor of the next video present path in a specified VidPN topology, given the current path.

Parameters

hVidPnTopology [in]

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.

pVidPnPresentPathInfo [in]

A pointer to a D3DKMDT_VIDPN_PRESENT_PATH structure that describes the current path. The display miniport driver previously obtained this pointer by calling pfnAcquireFirstPathInfo or pfnAcquireNextPathInfo.

ppNextVidPnPresentPathInfo [out]

A pointer to a variable that receives a pointer to a D3DKMDT_VIDPN_PRESENT_PATH structure that describes the next path.

Return value

The pfnAcquireNextPathInfo 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

When you have finished using the D3DKMDT_VIDPN_PRESENT_PATH structure, you must release the structure by calling pfnReleasePathInfo.

You can enumerate all the paths that belong to a VidPN topology object by calling pfnAcquireFirstPathInfo and then making a sequence of calls to pfnAcquireNextPathInfo.

The D3DKMDT_HVIDPNTOPOLOGY data type is defined in D3dkmdt.h.

See also

D3DKMDT_VIDPN_PRESENT_PATH

pfnAcqirePathInfo

pfnAcquireFirstPathInfo

pfnReleasePathInfo

View the official Windows Driver Kit DDI reference

Edit description on GitHub