D3DKMTInvalidateActiveVidPn 函数 (d3dkmthk.h)

  • 项目

D3DKMTInvalidateActiveVidPn 函数使当前正在使用 (VidPN) 的活动视频当前网络失效。

注意

此函数在 Windows 7 及更高版本的 Windows 操作系统中已过时。

语法

NTSTATUS D3DKMTInvalidateActiveVidPn(
  [in] const D3DKMT_INVALIDATEACTIVEVIDPN *unnamedParam1
);

参数

[in] unnamedParam1

指向 D3DKMT_INVALIDATEACTIVEVIDPN 结构的指针，该结构描述使当前使用的活动 VidPN 失效的参数。

返回值

D3DKMTInvalidateActiveVidPn 返回以下值之一：

返回代码 说明
STATUS_SUCCESS 当前使用的 VidPN 已成功失效。
STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER 在 D3DKMT_INVALIDATEACTIVEVIDPN 的 hAdapter 成员中未指定任何图形适配器来使 VidPN 失效。
STATUS_NO_MEMORY D3DKMTInvalidateActiveVidPn 由于内存不足而无法完成。
STATUS_NOT_SUPPORTED 显示微型端口驱动程序不支持由 D3DKMT_INVALIDATEACTIVEVIDPN 的 pPrivateDriverData 成员指向的缓冲区中的 OpenGL 可安装客户端驱动程序 (ICD ) 请求的显示模式。 如果显示微型端口驱动程序在运行 Windows 7 及更高版本的计算机上调用此函数，并且DXGKDDI_INTERFACE_VERSION = DXGKDDI_INTERFACE_VERSION_WIN7 >，则也会返回此状态值。
STATUS_DEVICE_REMOVED 图形适配器已停止。
STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN 显示微型端口驱动程序不建议使用 VidPN 来替换当前正在使用的 VidPN。

此函数还可能返回其他 NTSTATUS 值。

注解

调用 D3DKMTInvalidateActiveVidPn 函数使当前使用的 VidPN 失效时，当前 VidPN 将替换为显示微型端口驱动程序建议的新 VidPN。 由于显示微型端口驱动程序必须推荐新的 VidPN，因此显示微型端口驱动程序必须能够确定 OpenGL ICD 需要从 D3DKMT_INVALIDATEACTIVEVIDPN的 pPrivateDriverData 成员指向的缓冲区的显示模式。

OpenGL ICD 可以为显示模式调用 D3DKMTInvalidateActiveVidPn ， (例如，使用对 D3DKMTSetDisplayMode 函数的更常规调用不支持的克隆视图模式) 。

要求

要求 值
最低受支持的客户端 在 Windows Vista 和更高版本的 Windows 操作系统中可用，用于显示具有 < 版本DXGKDDI_INTERFACE_VERSION_WIN7的微型端口驱动程序。
目标平台 通用
标头 d3dkmthk.h (包括 D3dkmthk.h)
Library Gdi32.lib
DLL Gdi32.dll

另请参阅

D3DKMTSetDisplayMode

D3DKMT_INVALIDATEACTIVEVIDPN