DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO回调函数 （d3dkmddi.h）
pfnAcquirePathInfo 函数返回由视频演示源指定的视频演示路径的描述符，以及特定 VidPN 拓扑中的视频演示目标。
语法
DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO DxgkddiVidpntopologyAcquirepathinfo;
NTSTATUS DxgkddiVidpntopologyAcquirepathinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppVidPnPresentPathInfo
)
{...}
参数
[in] hVidPnTopology
VidPN 拓扑对象的句柄。 显示微型端口驱动程序以前通过调用 DXGK_VIDPN_INTERFACE 接口的 pfnGetTopology 函数来获取此句柄。
[in] VidPnSourceId
标识视频演示源的整数。
[in] VidPnTargetId
标识视频演示目标的整数。
[out] ppVidPnPresentPathInfo
指向一个变量的指针，该变量接收指向描述所请求路径的D3DKMDT_VIDPN_PRESENT_PATH结构的指针。
返回值
pfnAcquirePathInfo 函数返回以下值之一：
| 返回代码 | 描述 |
|---|---|
| STATUS_SUCCESS | 函数成功。 |
| STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | hVidPnTopology 中提供的句柄无效。 |
言论
使用完D3DKMDT_VIDPN_PRESENT_PATH结构后，必须通过调用 pfnReleasePathInfo释放结构。
路径包含（源、目标）对，拓扑是路径集合。 此函数返回指定拓扑中包含指定（源、目标）对的路径的描述符。
可以通过调用 pfnAcquireFirstPathInfo 并 pfnAcquireNextPathInfo来枚举属于 VidPN 拓扑对象的所有路径。
作系统分配 VidPN 源标识符。 DxgkDdiStartDevice（由显示微型端口驱动程序实现）返回显示适配器支持的视频演示源的数目 N。 然后，作系统分配标识符 0、1、2...N - 1.
显示微型端口驱动程序分配 VidPN 目标标识符。 DxgkDdiQueryChildRelations（由显示微型端口驱动程序实现）返回 DXGK_CHILD_DESCRIPTOR 结构的数组，每个结构都包含标识符。
D3DKMDT_HVIDPNTOPOLOGY数据类型在 D3dkmdt.h中定义。
D3dukmdt.h中定义了D3DDDI_VIDEO_PRESENT_SOURCE_ID和D3DDDI_VIDEO_PRESENT_TARGET_ID数据类型。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows Vista |
| 目标平台 | 桌面 |
| 标头 | d3dkmddi.h （包括 D3dkmddi.h） |
| IRQL | PASSIVE_LEVEL |