DXGKDDI_VIDPNTARGETMODESET_PINMODE回调函数 (d3dkmddi.h)

pfnPinMode 函数在 VidPN 目标模式集中固定指定模式。

语法

DXGKDDI_VIDPNTARGETMODESET_PINMODE DxgkddiVidpntargetmodesetPinmode;

NTSTATUS DxgkddiVidpntargetmodesetPinmode(
  [in] IN_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_CONST_D3DKMDT_VIDEO_PRESENT_TARGET_MODE_ID VidPnTargetModeId
)
{...}

参数

[in] hVidPnTargetModeSet

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

[in] VidPnTargetModeId

标识要固定的模式的整数。

返回值

pfnPinMode 函数返回以下值之一:

返回代码 说明
STATUS_SUCCESS 函数成功。
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET hVidPnTargetModeSet 中提供的句柄无效。
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET_MODE 由 VidPnTargetModeId 标识的模式不属于由 hVidPnTargetModeSet 表示的源模式集。

注解

VidPN 目标模式标识符由操作系统分配。 pfnCreateNewModeInfo 函数生成模式标识符,将标识符分配给 D3DKMDT_VIDPN_TARGET_MODE 结构的 Id 成员,并将结构返回到显示微型端口驱动程序。

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

要求

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