IDirect3DDeviceManager9：：ResetDevice 方法 (dxva2api.h)

  • 發行項

設定 Direct3D 裝置，或通知設備管理員 Direct3D 裝置已重設。

語法

HRESULT ResetDevice(
  [in] IDirect3DDevice9 *pDevice,
  [in] UINT             resetToken
);

參數

[in] pDevice

Direct3D 裝置 IDirect3DDevice9 介面的指標。

[in] resetToken

在 DXVA2CreateDirect3DDeviceManager9 函式的 pResetToken 參數中收到的令牌。

傳回值

此方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
 此方法已成功。
E_INVALIDARG
 權杖無效
D3DERR_INVALIDCALL
 Direct3D 裝置錯誤。

備註

當您第一次建立 Direct3D 設備管理員時，請使用 Direct3D 裝置的指標呼叫這個方法。 設備管理員不會建立裝置;呼叫端一開始必須提供裝置指標。

如果 Direct3D 裝置遺失，而且您需要重設裝置或建立新裝置，也請呼叫此方法。 如果 IDirect3DDevice9：：TestCo D3DERR_DEVICENOTRESET 傳回D3DERR_DEVICELOST或D3DERR_DEVICENOTRESET，就會發生這種情況。 如需遺失裝置的詳細資訊，請參閱 Direct3D 檔。

resetToken 參數可確保只有原本建立設備管理器的元件才能使目前的裝置失效。

如果此方法成功，所有開啟的裝置句柄都會變成無效。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 dxva2api.h

另請參閱

Direct3D 裝置管理員

IDirect3DDeviceManager9