DXGKDDI_VIDPNTOPOLOGY_GETPATHSOURCEFROMTARGET回调函数 (d3dkmddi.h)
pfnGetPathSourceFromTarget 函数返回与指定视频演示目标关联的视频演示源的标识符。
语法
DXGKDDI_VIDPNTOPOLOGY_GETPATHSOURCEFROMTARGET DxgkddiVidpntopologyGetpathsourcefromtarget;
NTSTATUS DxgkddiVidpntopologyGetpathsourcefromtarget(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidTopology,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[out] OUT_PD3DDDI_VIDEO_PRESENT_SOURCE_ID pVidPnSourceId
)
{...}
参数
[in] hVidTopology
VidPN 拓扑对象的句柄。 显示微型端口驱动程序以前通过调用 DXGK_VIDPN_INTERFACE 接口的 pfnGetTopology 函数来获取此句柄。
[in] VidPnTargetId
标识特定视频演示源的整数。
[out] pVidPnSourceId
指向接收视频演示源标识符的变量的指针。
返回值
pfnGetPathSourceFromTarget 函数返回以下值之一:
返回代码 | 描述 |
---|---|
STATUS_SUCCESS | 函数成功。 |
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | hVidPnTopology 中提供的句柄无效。 |
STATUS_INVALID_PARAMETER | pVidPnSourceId 中提供的指针有效。 |
言论
拓扑是一个集合路径,每个路径都包含一个(源、目标)对。 特定目标最多属于一个路径,因此给定目标 ID 时,最多有一个与该目标关联的源。
作系统分配 VidPN 源标识符。 DxgkDdiStartDevice(由显示微型端口驱动程序实现)返回显示适配器支持的视频演示源的数目 N。 然后,作系统分配标识符 0、1、2...N - 1.
显示微型端口驱动程序分配 VidPN 目标标识符。 DxgkDdiQueryChildRelations(由显示微型端口驱动程序实现)返回 DXGK_CHILD_DESCRIPTOR 结构的数组,每个结构都包含标识符。
D3DKMDT_HVIDPNTOPOLOGY数据类型在 D3dkmdt.h中定义。
D3DDDI_VIDEO_PRESENT_SOURCE_ID D3DDDI_VIDEO_PRESENT_TARGET_ID数据类型在 D3dukmdt.h中定义。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows Vista |
目标平台 | 桌面 |
标头 | d3dkmddi.h (包括 D3dkmddi.h) |
IRQL | PASSIVE_LEVEL |