ChangeDisplaySettings

功能

該函式把預設顯示設備的設定改變為由lpDevMode設定的圖形模式，要改變一個特定顯示設備的設定，請使用ChangeDisplaySettingsEx函式。

函式原型：LONG ChangeDisplaySettings (LPDEVMODE lpDevMode, DWORD dwflags)；

lpDevMode：指向一個描述轉變圖表的DEVMODE的指針。DEVMODE的dmSize參數必須依DEVMODE結構的大小、位元組進行初始化，dmDriveExtra參數必須初始化來顯示DEVMODE隨後的驅動數據的位元組數，另外還可以選用以下參數：

dmBitsPerPel每個像素的位數，dmPelsWidth螢幕寬度（像素），dmPelsHeight螢幕高度（像素），dmDisplayFlage模式標誌。

dmDisplayFrequency模式頻率。

dmposition在多顯示配置中設備的位置（適用於Windows 98、Windows NT 5.0及以後版本）。

除了設定好DEVMOD結構中諸多元素的值之外，還必須要正確地設定dmFields元素中的標誌。這些標誌表明了DEVMODE結構中哪個元素在改變顯示設定時使用了。如果在dmFields中沒有設定正確的位，那么顯示設定將不會發生變化。請設定好以下的標誌：

DM_BITSPERPEL使用dmBitsPerPel的值，DM_PELSWIDTH使用dmPelsWidth的值，

DM_PELSHEIGHT使用dmPelsHeight的值，DM_DISPLAYFLAGS使用dmDisplayFlags的值，

DM_DISPLAYFREQUENCY使用dmDisplayFrequency的值。

DM_POSITION使用fdmPosition的值（適用於Windows98、WindowsNT5.0）。

如果lpDevMode為空。那么顯示設定就使用註冊表中的所有當前值。在顯示模式動態地調整之後要想再回到預設的模式，最簡單的辦法就是把lpDevMode參數置為空，使dwFlags參數置為0。

dwflags：表明了圖形模式如何改變，它可能是如下的幾種形式中的一種：

0：表明當前螢幕的圖形模式要動態地改變。

CDS_UPDATEREGISTRY：表明當前螢幕的圖形模式會動態地變化，並且該圖形模式會更新註冊表。該模式信息存貯在用戶檔案中。

CDS_TEST：系統檢測是否要設定被請求的圖形模式。

CDS_FULLSCREEN：從本質上講該模式是暫時的。

CDS_GLOBAL：該設定保存在全局設定區域內，因此它們會影響所有的用戶。該標誌僅在與標誌一起使用時才有效。CDS_SET_PRIMARY：該設備成為首要設備。

CDS_RESET：設定要改變，即使請求的設定與當前設定一樣。CDS_NORESET：設定保存在註冊表中，但是它不起作用，該標誌只有與CDS_UPDATEREGISTRY標誌一起使用時才有效。

指定CDS_TEST允許一個套用確定哪個圖形模式真正的有效。但並不會使系統變為那個有效的圖形模式。