This topic has not yet been rated - Rate this topic

IDirect3DDeviceManager9::TestDevice method

Tests whether a Direct3D device handle is valid.


HRESULT TestDevice(
  [in]  HANDLE hDevice
);

hDevice [in]: Handle to a Direct3D device. To get a device handle, call IDirect3DDeviceManager9::OpenDeviceHandle.

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code	Description
S_OK	The device handle is valid.
E_HANDLE	The specified handle is not a Direct3D device handle.
DXVA2_E_NEW_VIDEO_DEVICE	The device handle is invalid.

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

Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Header	Dxva2api.h

Community Additions