How to use the D3DKMTInvalidateActiveVidPn function to change desktop display settings in Windows Vista

How to use the D3DKMTInvalidateActiveVidPn function to change desktop display settings in Windows Vista

Article ID : 930088
Last Review : March 15, 2007
Revision : 1.2


This article contains information about how to use the D3DKMTInvalidateActiveVidPn function in Windows Vista. This function invalidates the video present network (VidPN) that the video graphics driver is using.


Typically, you use the ChangeDisplaySettingsEx function to set the desktop display settings. However, on a display device that uses the Windows Vista graphics driver model driver, third-party programs and utilities can use the D3DKMTInvalidateActiveVidPn function to set display settings.

When you use the D3DKMTInvalidateActiveVidPn function, Windows Vista queries the third-party kernel-mode driver. Therefore, you have more control over the settings than you have when you use the ChangeDisplaySettingsEx function. However, the D3DKMTInvalidateActiveVidPn function does not include a complete superset of the Microsoft Windows graphics device interface (GDI) display configuration API. Also, the D3DKMTInvalidateActiveVidPn function always resets a multimonitor desktop to the default configuration. Therefore, you may have to use the ChangeDisplaySettingsEx function after you use the D3DKMTInvalidateActiveVidPn function so that you can successfully take the following actions:

• Change the primary display
• Extend the desktop to a second display and then set the relative position of the displays

Note Because this process requires two steps, the screen may flash two times as the new settings are applied.

For more information about the D3DKMTInvalidateActiveVidPn function, visit the following Microsoft Web site: (

• Windows Vista Home Basic
• Windows Vista Home Premium
• Windows Vista Ultimate
• Windows Vista Business
• Windows Vista Enterprise
• Windows Vista Home Basic 64-bit edition
• Windows Vista Home Premium 64-bit edition
• Windows Vista Ultimate 64-bit edition
• Windows Vista Enterprise 64-bit edition
• Windows Vista Starter

Back to the top

kbhowto kbinfo kbexpertiseadvanced KB930088


Microsoft Knowledge Base Article

This article contents is Microsoft Copyrighted material.
Microsoft Corporation. All rights reserved. Terms of Use | Trademarks

You can follow any responses to this entry through the RSS 2.0 feed. You can leave a response, or trackback from your own site.

AddThis Social Bookmark Button

Leave a Reply

To prove that you're not a bot, enter this code
Anti-Spam Image