IDirect3DDeviceManager9::TestDevice 方法 (dxva2api.h)

测试 Direct3D 设备句柄是否有效。

语法

HRESULT TestDevice(
  [in] HANDLE hDevice
);

参数

[in] hDevice

Direct3D 设备的句柄。 若要获取设备句柄,请调用 IDirect3DDeviceManager9::OpenDeviceHandle

返回值

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
设备句柄有效。
E_HANDLE
指定的句柄不是 Direct3D 设备句柄。
DXVA2_E_NEW_VIDEO_DEVICE
设备句柄无效。

备注

如果方法返回DXVA2_E_NEW_VIDEO_DEVICE,请调用 IDirect3DDeviceManager9::CloseDeviceHandle 以关闭句柄,然后再次调用 OpenDeviceHandle 以获取新句柄。 IDirect3DDeviceManager9::ResetDevice 方法使所有打开的设备句柄失效。

要求

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

另请参阅

Direct3D 设备管理器

IDirect3DDeviceManager9