DXGKDDI_VIDPN_GETTOPOLOGY回调函数 (d3dkmddi.h)

  • 项目

pfnGetTopology 函数返回由指定的 VidPN 对象包含的 VidPN 拓扑对象的句柄。

语法

DXGKDDI_VIDPN_GETTOPOLOGY DxgkddiVidpnGettopology;

NTSTATUS DxgkddiVidpnGettopology(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [out] OUT_PD3DKMDT_HVIDPNTOPOLOGY phVidPnTopology,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNTOPOLOGY_INTERFACE ppVidPnTopologyInterface
)
{...}

参数

[in] hVidPn

VidPN 对象的句柄。 VidPN 管理器以前通过调用 DxgkDdiEnumVidPnCofuncModality、 DxgkDdiIsSupportedVidPn 或 DxgkDdiRecommendFunctionalVidPn 向显示微型端口驱动程序提供了此句柄。

[out] phVidPnTopology

指向变量的指针，该变量接收 VidPN 拓扑对象的句柄。

[out] ppVidPnTopologyInterface

指向变量的指针，该变量接收指向 DXGK_VIDPNTOPOLOGY_INTERFACE 结构的指针。 结构包含指向显示微型端口驱动程序可以调用以检查和更改 VidPN 拓扑对象的函数的指针。

返回值

pfnGetTopology 函数返回以下值之一：

返回代码 说明
STATUS_SUCCESS 函数成功。
STATUS_GRAPHICS_INVALID_VIDPN hVidPn 中提供的句柄无效。

注解

显示微型端口驱动程序不需要释放它在 phVidPnTopology 中收到的句柄。

ppVidPnTopologyInterface 中返回的DXGK_VIDPNTOPOLOGY_INTERFACE结构的生存期归操作系统所有。 使用此所有权方案，操作系统可以在运行时迁移到较新的实现，而不会中断接口的客户端。

要求

要求 值
最低受支持的客户端 Windows Vista
目标平台 桌面
标头 d3dkmddi.h (包括 D3dkmddi.h)
IRQL PASSIVE_LEVEL

另请参阅

DXGK_VIDPNTOPOLOGY_INTERFACE

VidPN 拓扑接口