CBaseWindow.DoneWithWindow method

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The DoneWithWindow method destroys the window.

Syntax

virtual HRESULT DoneWithWindow();

Parameters

This method has no parameters.

Return value

Returns S_OK.

Remarks

Call this method from the derived object's destructor method.

If this method is called from the same thread that created the window, the method performs the following actions:

• Calls the CBaseWindow::InactivateWindow method, which deactivates the window.
• Calls the CBaseWindow::UninitialiseWindow method, which releases resources used by the window.
• Destroys the window.

If the thread calling DoneWithWindow is not the thread that created the window, the method sends a private "destroy" message to the window. When the window receives this message, it calls DoneWithWindow on itself. (If CBaseWindow::m_bDoPostToDestroy is TRUE, the window posts the message.)

Requirements

See also

CBaseWindow Class