通过

DXGKDDI_RECOMMENDFUNCTIONALVIDPN回调函数 （d3dkmddi.h）

  • 项目

DxgkDdiRecommendFunctionalVidPn 函数创建可在指定显示适配器上实现的功能 VidPN。

语法

DXGKDDI_RECOMMENDFUNCTIONALVIDPN DxgkddiRecommendfunctionalvidpn;

NTSTATUS DxgkddiRecommendfunctionalvidpn(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_RECOMMENDFUNCTIONALVIDPN_CONST pRecommendFunctionalVidPn
)
{...}

参数

[in] hAdapter

与显示适配器关联的上下文块的句柄。 显示微型端口驱动程序以前向 MiniportDeviceContext 中的 DirectX 图形内核子系统提供了此句柄，DxgkDdiAddDevice 函数的输出参数。

[in] pRecommendFunctionalVidPn

指向包含函数参数的 DXGKARG_RECOMMENDFUNCTIONALVIDPN 结构的指针。 调用方提供 hRecommendedFunctionalVidPn 成员，该成员是空 VidPN 对象的句柄。 DxgkDdiRecommendFunctionalVidPn 使用功能 VidPN 的元素填充 VidPN 对象：拓扑、模式集、固定模式。

返回值

DxgkDdiRecommendFunctionalVidPn 返回以下值之一：

返回代码 描述
STATUS_SUCCESS 该函数已成功创建功能 VidPN。
STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN 该函数无法创建功能 VidPN。
STATUS_NO_MEMORY 函数失败，因为它无法分配内存。

言论

如果 VidPN 满足以下条件，则其功能正常：

  • 它具有至少一个路径的拓扑。 （路径是源与目标之间的关联。
  • 拓扑中的每个源和目标都有固定模式。
DxgkDdiRecommendFunctionalVidPn 的工作是创建可在显示适配器上实现的功能 VidPN。 以下列表提供了用于创建功能 VidPN 的步骤。
  1. 从空 VidPN 对象的句柄开始。 此句柄是在 pRecommendFunctionalVidPnArg 的 hDesiredVidPn 成员中提供的。
  2. 将路径（源-目标对）添加到 VidPN 的拓扑中。
  3. 创建新的源模式集，并将一个源模式添加到该集。 将源模式设置为路径中的源。 固定源模式。
  4. 创建新的目标模式集，并将一个目标模式添加到集。 将目标模式设置为路径中的目标。 固定目标模式。
有关如何添加路径、添加模式集、分配模式和引脚模式的信息，请参阅 VidPN 对象和接口。

应 DxgkDdiRecommendFunctionalVidPn 进行分页。

要求

要求 价值
最低支持的客户端 Windows Vista
目标平台 桌面
标头 d3dkmddi.h
IRQL PASSIVE_LEVEL