IMFDXGIDeviceManager::TestDevice 方法 (mfobjects.h)

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

语法

HRESULT TestDevice(
  [in] HANDLE hDevice
);

参数

[in] hDevice

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

返回值

此方法可以返回其中一个值。

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

注解

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

要求

要求
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows
标头 mfobjects.h (包括 Mfidl.h)

另请参阅

IMFDXGIDeviceManager