IMFDXGIDeviceManager::TestDevice method (mfobjects.h)

Tests whether a Microsoft Direct3D device handle is valid.

Syntax

HRESULT TestDevice(
  [in] HANDLE hDevice
);

Parameters

[in] hDevice

A handle to the Direct3D device. To get the device handle, call IMFDXGIDeviceManager::OpenDeviceHandle.

Return value

This method can return one of these values.

Return code Description
S_OK
Success.
E_HANDLE
The specified handle is not a Direct3D device handle.
MF_E_DXGI_NEW_VIDEO_DEVICE
The device handle is invalid.

Remarks

If the method returns MF_E_DXGI_NEW_VIDEO_DEVICE, call IMFDXGIDeviceManager::CloseDeviceHandle to close the handle and then call OpenDeviceHandle again to get a new handle. The IMFDXGIDeviceManager::ResetDevice method invalidates all open device handles.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 [desktop apps | UWP apps]
Target Platform Windows
Header mfobjects.h (include Mfidl.h)

See also

IMFDXGIDeviceManager