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 从 pPrivateDriverData 成员 D3DKMT_INVALIDATEACTIVEVIDPN指向的缓冲区所需的显示模式。
OpenGL ICD 可以使用对 D3DKMTSetDisplayMode 函数的更常规调用来调用 D3DKMTInvalidateActiveVidPn（例如克隆视图模式）。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 在 Windows Vista 和更高版本的 Windows作系统中提供，用于显示具有版本 < DXGKDDI_INTERFACE_VERSION_WIN7 的微型端口驱动程序。 |
| 目标平台 | 普遍 |
| 标头 | d3dkmthk.h （包括 D3dkmthk.h） |
| 库 | Gdi32.lib |
| DLL | Gdi32.dll |