D3DKMTSetDisplayMode 函式 （d3dkmthk.h）
D3DKMTSetDisplayMode 函式會設定用來掃描顯示器的配置。
語法
NTSTATUS D3DKMTSetDisplayMode(
[in, out] const D3DKMT_SETDISPLAYMODE *unnamedParam1
);
參數
[in, out] unnamedParam1
描述用來掃描的配置之 D3DKMT_SETDISPLAYMODE 結構的指標。
傳回值
D3DKMTSetDisplayMode 會傳回下列其中一個值：
| 傳回碼 | 描述 |
|---|---|
| STATUS_SUCCESS | 已成功設定顯示模式。 |
| STATUS_DEVICE_REMOVED | 圖形適配卡已停止，或重設顯示裝置。 |
| STATUS_INVALID_PARAMETER | 已驗證參數，並判斷為不正確。 |
| STATUS_GRAPHICS_NOT_EXCLUSIVE_MODE_OWNER | 在呼叫 D3DKMTSetDisplayMode之前，裝置未取得檢視的獨佔擁有權。 因此，裝置無法設定顯示模式。 |
| D3DDDIERR_INCOMPATIBLEPRIVATEFORMAT | OpenGL 可安裝用戶端驅動程式 （ICD） 必須將與 D3DKMT_SETDISPLAYMODEhPrimaryAllocation 成員所指定之配置關聯的介面格式轉換為 PrivateDriverFormatAttributeD3DKMT_SETDISPLAYMODE 成員所指定之 format 屬性。 ICD 接著應該再次呼叫 D3DKMTSetDisplayMode。 ICD 可以配置新的配置、執行從舊主要到新的轉換位區塊傳輸（bitblt），然後只要 ICD 針對所有後續作業使用此配置的新配置句柄，就會終結舊的主要複本。 ICD 應該重複此程式，直到 D3DKMTSetDisplayMode 傳回不同的傳回值為止。 |
此函式也可能傳回其他 NTSTATUS 值。
言論
OpenGL ICD 呼叫 D3DKMTSetDisplayMode，以設定使用擴充格式、多重取樣方法或兩者的新顯示模式之前，ICD 必須確保目前的 GDI 顯示模式與新的顯示模式具有相同解析度。 否則，D3DKMTSetDisplayMode 會傳回 STATUS_INVALID_PARAMETER。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 目標平臺 | 普遍 |
| 標頭 | d3dkmthk.h （包括 D3dkmthk.h） |
| 連結庫 | Gdi32.lib |
| DLL | Gdi32.dll |