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
| Requirement | Value |
|---|---|
| Header |
|
| Library |
|