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 |