IMFDXGIDeviceManager::ResetDevice Method

Sets the Microsoft Direct3D device or notifies the device manager that the Microsoft Direct3D device was reset.

Syntax

public:
HRESULT ResetDevice(
         IUnknown *pUnkDevice,
         UINT resetToken
)  

Parameters

pUnkDevice
Type: IUnknown *

[in] A pointer to the IUnknown interface of the Microsoft DirectX Graphics Infrastructure (DXGI) device.

resetToken
Type: UINT 

[in] The token that was received in the pResetToken parameter of the MFCreateDXGIDeviceManager function.

Return value

Type: HRESULT 

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Refer to Media Foundation return codes.

Remarks

When you first create the Microsoft DirectX Graphics Infrastructure (DXGI) Device Manager, call this method with a pointer to the Microsoft Direct3D device. (The device manager does not create the device; the caller must provide the device pointer initially.) Also call this method if the Microsoft Direct3D device becomes lost and you need to reset the device or create a new device.

The resetToken parameter ensures that only the component that originally created the device manager can invalidate the current device.

If this method succeeds, all open device handles become invalid.

Requirements

Header: Declared in mfobjects.h (include mfidl.h).