DXGKDDI_VIDPNSOURCEMODESET_ADDMODE回调函数 (d3dkmddi.h)
pfnAddMode 函数将 VidPN 源模式添加到指定的 VidPN 源模式集对象。
语法
DXGKDDI_VIDPNSOURCEMODESET_ADDMODE DxgkddiVidpnsourcemodesetAddmode;
NTSTATUS DxgkddiVidpnsourcemodesetAddmode(
[in] IN_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
[in] IN_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo
)
{...}
参数
[in] hVidPnSourceModeSet
VidPN 源模式集对象的句柄。 显示微型端口驱动程序以前通过调用 DXGK_VIDPN_INTERFACE 接口的 pfnAcquireSourceModeSet 函数来获取此句柄。
[in] pVidPnSourceModeInfo
指向描述源模式 的D3DKMDT_VIDPN_SOURCE_MODE 结构的指针。 显示微型端口驱动程序以前通过调用 pfnCreateNewModeInfo 获取此结构。
返回值
pfnAddMode 函数返回以下值之一：
| 返回代码 | 说明 |
|---|---|
| STATUS_SUCCESS | 函数成功。 |
| STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET | hVidPnSourceModeSet 中提供的句柄无效。 |
注解
若要将模式添加到源模式集，显示微型端口驱动程序将执行以下步骤。
调用 pfnCreateNewModeInfo 以获取指向 D3DKMDT_VIDPN_SOURCE_MODE 结构的指针。 pnfCreateNewModeInfo 函数分配 结构，使用新生成的源模式标识符填充 Id 成员，并将 Type 成员设置为D3DKMDT_RMT_UNINITIALIZED。
使用有关模式的信息（包括模式类型和格式）填充 D3DKMDT_VIDPN_SOURCE_MODE 结构 (Id 成员) 除外。
调用 pfnAddMode 将模式添加到源模式集。
调用 pfnCreateNewModeInfo 时，VidPN 管理器分配D3DKMDT_VIDPN_SOURCE_MODE结构。 如果将该结构描述的模式添加到源模式集，则无需显式释放结构; pfnAddMode 释放它。
如果通过调用 pfnCreateNewModeInfo 获取D3DKMDT_VIDPN_SOURCE_MODE结构，然后决定不将该模式添加到源模式集，则必须通过调用 pfnReleaseModeInfo 显式释放结构。
D3DKMDT_HVIDPNSOURCEMODESET数据类型在 D3dkmdt.h 中定义。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 目标平台 | 桌面 |
| 标头 | d3dkmddi.h (包括 D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |