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