DXGKDDI_VIDPNTARGETMODESET_CREATENEWMODEINFO回调函数 (d3dkmddi.h)

项目
02/23/2024

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结构后，必须执行以下一项操作，但不能同时执行两项操作：

填充结构的 Info 成员，并将结构传递给 pfnAddMode。
通过调用 pfnReleaseModeInfo 释放结构。

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

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