DXGKDDI_VIDPNTARGETMODESET_ADDMODE回调函数 (d3dkmddi.h)

pfnAddMode 函数将 VidPN 目标模式添加到指定的 VidPN 目标模式集对象。

语法

DXGKDDI_VIDPNTARGETMODESET_ADDMODE DxgkddiVidpntargetmodesetAddmode;

NTSTATUS DxgkddiVidpntargetmodesetAddmode(
  [in] IN_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_PD3DKMDT_VIDPN_TARGET_MODE_CONST pVidPnTargetModeInfo
)
{...}

参数

[in] hVidPnTargetModeSet

VidPN 目标模式集对象的句柄。 显示微型端口驱动程序以前通过调用 DXGK_VIDPN_INTERFACE 接口的 pfnAcquireTargetModeSet 函数来获取此句柄。

[in] pVidPnTargetModeInfo

指向描述目标模式 的D3DKMDT_VIDPN_TARGET_MODE 结构的指针。 显示微型端口驱动程序以前通过调用 pfnCreateNewModeInfo 获取此结构。

返回值

pfnAddMode 函数返回以下值之一：

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

注解

若要将模式添加到目标模式集，显示微型端口驱动程序将执行以下步骤。

1. 调用 pfnCreateNewModeInfo 以获取指向 D3DKMDT_VIDPN_TARGET_MODE 结构的指针。 pnfCreateNewModeInfo 函数分配 结构，并使用新生成的目标模式标识符填充 Id 成员。
2. D3DKMDT_VIDPN_TARGET_MODE 结构的 Info 成员是 D3DKMDT_VIDEO_SIGNAL_MODE 结构。 使用有关模式的信息填充该结构。
3. 调用 pfnAddMode 将模式添加到目标模式集。

调用 pfnCreateNewModeInfo 时，VidPN 管理器分配D3DKMDT_VIDPN_TARGET_MODE结构。 如果将该结构描述的模式添加到目标模式集，则无需显式释放结构; pfnAddMode 释放它。

如果通过调用 pfnCreateNewModeInfo 获取D3DKMDT_VIDPN_TARGET_MODE结构，然后决定不将该模式添加到目标模式集，则必须通过调用 pfnReleaseModeInfo 显式释放结构。

D3DKMDT_HVIDPNTARGETMODESET数据类型在 D3dkmdt.h 中定义。

要求

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

另请参阅

D3DKMDT_VIDPN_TARGET_MODE

pfnCreateNewModeInfo

pfnReleaseModeInfo