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

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

[in] pRecommendFunctionalVidPn

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

返回值

DxgkDdiRecommendFunctionalVidPn 返回以下值之一：

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

注解

如果 VidPN 满足以下条件，则它是正常运行的：

• 它具有至少一个路径的拓扑。 (路径是源和 target 之间的关联。)
• 拓扑中的每个源和目标都有固定模式。

DxgkDdiRecommendFunctionalVidPn 的工作是创建可在显示适配器上实现的功能性 VidPN。 以下列表提供了用于创建功能 VidPN 的步骤。

1. 从空 VidPN 对象的句柄开始。 此句柄是在 pRecommendFunctionalVidPnArg 的 hDesiredVidPn 成员中提供的。
2. 将路径 (源目标对) 添加到 VidPN 的拓扑。
3. 创建新的源模式集，并将一个源模式添加到该集。 将源模式集分配给路径中的源。 固定源模式。
4. 创建新的目标模式集，并将一个目标模式添加到该集。 将目标模式集分配给路径中的目标。 固定目标模式。

有关如何添加路径、添加模式集、分配模式和固定模式的信息，请参阅 VidPN 对象和接口。

应使 DxgkDdiRecommendFunctionalVidPn 可分页。

要求

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