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