通过

DXGKDDI_VIDPNTARGETMODESET_CREATENEWMODEINFO回调函数 （d3dkmddi.h）

  • 项目

pfnCreateNewModeInfo 函数返回指向显示微型端口驱动程序在调用 pfnAddMode之前填充的 D3DKMDT_VIDPN_TARGET_MODE 结构的指针。

语法

DXGKDDI_VIDPNTARGETMODESET_CREATENEWMODEINFO DxgkddiVidpntargetmodesetCreatenewmodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetCreatenewmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [out] DEREF_OUT_PPD3DKMDT_VIDPN_TARGET_MODE ppNewVidPnTargetModeInfo
)
{...}

参数

[in] hVidPnTargetModeSet

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

[out] ppNewVidPnTargetModeInfo

指向一个变量的指针，该变量接收指向 VidPN 管理器分配的D3DKMDT_VIDPN_TARGET_MODE结构的指针。

返回值

pfnCreateNewModeInfo 函数返回以下值之一：

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

言论

pfnCreateNewModeInfo 函数分配 D3DKMDT_VIDPN_TARGET_MODE 结构，并将其 Id 成员设置为新生成的标识符。

调用 pfnCreateNewModeInfo 以获取D3DKMDT_VIDPN_TARGET_MODE结构后，必须执行下列作之一（而非两者）：

填充D3DKMDT_VIDPN_TARGET_MODE结构时，可以选择覆盖 由 pfnCreateNewModeInfo生成的 ID 成员。 但是，如果覆盖任何D3DKMDT_VIDPN_TARGET_MODE结构的 Id 成员，则必须覆盖从 pfnCreateNewModeInfo获取的所有D3DKMDT_VIDPN_TARGET_MODE结构 ID 成员。 除非有覆盖 ID 成员的特定原因（例如，使用自己的编号方案跟踪目标模式），否则应按 pfnCreateNewModeInfo设置它们。

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

要求

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

另请参阅

D3DKMDT_VIDPN_TARGET_MODE

pfnAddMode

pfnReleaseModeInfo