IDirect3DDevice9Ex：：ResetEx 方法 (d3d9.h)

  • 發行項

使用所有其他表面持續重設交換鏈結的類型、大小和格式。

語法

HRESULT ResetEx(
  [in, out] D3DPRESENT_PARAMETERS *pPresentationParameters,
  [in, out] D3DDISPLAYMODEEX      *pFullscreenDisplayMode
);

參數

[in, out] pPresentationParameters

類型： D3DPRESENT_PARAMETERS*

描述新簡報參數 之D3DPRESENT_PARAMETERS 結構的指標。 此值不可為 NULL。

切換至全螢幕模式時，Direct3D 會嘗試尋找符合後台緩衝區格式的桌面格式，讓後端緩衝區和前端緩衝區格式相同 (，以消除色彩轉換) 的需求。

這個方法傳回時：

  • BackBufferCount、BackBufferWidth 和 BackBufferHeight 會設定為零。
  • BackBufferFormat 只會針對視窗模式設定為 D3DFORMAT ;全螢幕模式必須指定格式。

[in, out] pFullscreenDisplayMode

類型： D3DDISPLAYMODEEX*

描述所需顯示模式屬性 之D3DDISPLAYMODEEX 結構的指標。 必須為全螢幕應用程式提供此值，但可為視窗化應用程式提供 NULL 。

傳回值

類型： HRESULT

方法可以傳回：D3D_OK、D3DERR_DEVICELOST或D3DERR_DEVICEHUNG (请参阅 D3DERR) 。

如果此方法傳回D3DERR_DEVICELOST或D3DERR_DEVICEHUNG，則應用程式只能呼叫 IDirect3DDevice9Ex：：ResetEx、 IDirect3DDevice9Ex：：CheckDeviceState 或釋放介面指標;任何其他 API 呼叫都會造成例外狀況。

備註

如果呼叫 IDirect3DDevice9Ex：：ResetEx 失敗，裝置將會處於遺失狀態 (，如從呼叫 IDirect3DDevice9Ex：：CheckDeviceState) 傳回 D3DERR_DEVICELOST值所表示。 如需在遺失裝置內容中使用 IDirect3DDevice9Ex：：ResetEx 的詳細資訊，請參閱 IDirect3DDevice9Ex：：CheckDeviceState 和遺失裝置行為變更。

不同於舊版的 DirectX，呼叫 IDirect3DDevice9Ex：：ResetEx 不會造成表面、紋理或狀態信息遺失。

圖元著色器和頂點著色器在 IDirect3DDevice9Ex：：ResetEx呼叫 Direct3D 9 時存留。 應用程式不需要明確地重新建立它們。

交換鏈結有兩種不同類型的：全螢幕或視窗化。 如果新的交換鏈結是全螢幕，配接器將會放在符合新大小的顯示模式中。

應用程式可能需要在此呼叫期間將訊息傳送給它們 (，例如，在傳回此呼叫之前) ;應用程式應該採取預防措施，不要目前呼叫 Direct3D。

如果在與用來建立重設裝置不同的線程上呼叫 IDirect3DDevice9Ex：：ResetEx ，將會失敗。

呼叫 IDirect3D9Ex：：CreateDeviceEx、 IDirect3DDevice9Ex：：ResetEx 和 IDirect3DDevice9：：CreateAdditionalSwapChain 時，可以針對視窗模式後台緩衝區格式指定D3DFMT_UNKNOWN。 這表示應用程式不需要在呼叫 IDirect3D9Ex：：CreateDeviceEx 進行視窗模式之前查詢目前的桌面格式。 針對全螢幕模式，必須指定後台緩衝區格式。 將BackBufferCount 設定為等於零 (BackBufferCount = 0) 會產生一個後端緩衝區。

嘗試重設群組中的多個顯示適配卡時，請將 pPresentationParameters 設定為指向 D3DPRESENT_PARAMETERS 結構的數位，一個用於適配卡群組中的每個顯示。

如果使用 D3DCREATE_ADAPTERGROUP_DEVICE 建立多頭裝置， IDirect3DDevice9Ex：：ResetEx 需要 D3DPRESENT_PARAMETERS 結構的數位，其中每個結構都必須指定全屏幕顯示器。 若要切換回視窗模式，應用程式必須終結裝置，並在視窗模式中重新建立非多頭裝置。

規格需求

需求 值
目標平台 Windows
標頭 d3d9.h
程式庫 D3D9.lib

另請參閱

IDirect3DDevice9Ex