Microsoft KB Archive/930088

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

Article ID: 930088

Article Last Modified on 3/15/2007

-

APPLIES TO


 * 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

-



INTRODUCTION
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.



MORE INFORMATION
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:

http://msdn2.microsoft.com/en-us/library/aa478331.aspx

Keywords: kbhowto kbinfo kbexpertiseadvanced KB930088

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.