nc-d3dkmddi-dxgkddi_vidpntopology_acquirefirstpathinfo.md

UID	title	description	old-location	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	tech.root	req.typenames	f1_keywords	topic_type	api_type	api_location	api_name
NC:d3dkmddi.DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO	DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO (d3dkmddi.h)	The pfnAcquireFirstPathInfo structure returns a descriptor of the first path in a specified VidPN topology object.	display\dxgk_vidpntopology_interface_pfnacquirefirstpathinfo.htm	05/10/2018	DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO callback function	DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO, DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO callback, VidPnFunctions_d45dd9b3-775b-41a6-a5e4-8fb226ed7ea4.xml, d3dkmddi/pfnAcquireFirstPathInfo, display.dxgk_vidpntopology_interface_pfnacquirefirstpathinfo, pfnAcquireFirstPathInfo, pfnAcquireFirstPathInfo callback function [Display Devices]	d3dkmddi.h	D3dkmddi.h	Desktop	Windows Vista													PASSIVE_LEVEL	Windows	display		DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO d3dkmddi/DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO	APIRef kbSyntax	UserDefined	d3dkmddi.h	DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO

DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO callback function

-description

The pfnAcquireFirstPathInfo structure returns a descriptor of the first path in a specified VidPN topology object.

-parameters

-param 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.

-param ppFirstVidPnPresentPathInfo [out]

A pointer to a variable that receives a pointer to a D3DKMDT_VIDPN_PRESENT_PATH structure. The structure contains a variety of information about the path, including the path's source and target identifiers.

-returns

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

pfnAcquireNextPathInfo

pfnReleasePathInfo