通过

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：：TestCooperativeLevel 返回D3DERR_DEVICELOST或D3DERR_DEVICENOTRESET，则会发生这种情况。 有关丢失设备的详细信息，请参阅 Direct3D 文档。

resetToken 参数可确保只有最初创建设备管理器的组件才能使当前设备失效。

如果此方法成功，则所有打开的设备句柄都无效。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 dxva2api.h

另请参阅

Direct3D 设备管理器

IDirect3DDeviceManager9