通过

DXGKDDI_VIDPNSOURCEMODESET_CREATENEWMODEINFO回调函数 （d3dkmddi.h）

  • 项目

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

语法

DXGKDDI_VIDPNSOURCEMODESET_CREATENEWMODEINFO DxgkddiVidpnsourcemodesetCreatenewmodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetCreatenewmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [out] DEREF_OUT_PPD3DKMDT_VIDPN_SOURCE_MODE ppNewVidPnSourceModeInfo
)
{...}

参数

[in] hVidPnSourceModeSet

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

[out] ppNewVidPnSourceModeInfo

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

返回值

pfnCreateNewModeInfo 函数返回以下值之一：

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

言论

pfnCreateNewModeInfo 函数分配 D3DKMDT_VIDPN_SOURCE_MODE 结构，将其 ID 成员设置为新生成的标识符，并将其 Type 成员设置为 D3DKMDT_RMT_UNINITIALIZED。

调用 pfnCreateNewModeInfo 以获取D3DKMDT_VIDPN_SOURCE_MODE结构后，必须执行下列作之一，但不能同时执行这两个结构：

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

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

要求

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

另请参阅

D3DKMDT_VIDPN_SOURCE_MODE

pfnAddMode

pfnReleaseModeInfo