ID3DDestructionNotifier interface (d3dcommon.h)
ID3DDestructionNotifier is an interface that you can use to register for callbacks when a Direct3D nano-COM object is destroyed.
To acquire an instance of this interface, call on a Direct3D object with the IID of ID3DDestructionNotifier.
Using ID3DDestructionNotifier instead of ID3D12Object::SetPrivateDataInterface or Direct3D 11 equivalents provides stronger guarantees about the order of destruction. With ID3DDestructionNotifier, implicit relationships—such as an ID3D11View holding a reference to its underlying ID3D11Resource—are guaranteed to be valid and for the referenced object (here, the ID3D11Object) to still be alive when the destruction callback is invoked. With ID3D12Object::SetPrivateDataInterface, the implicit references can be released before the destruction callback is invoked.
It isn't safe to access the object being destructed during the callback.
Inheritance
The ID3DDestructionNotifier interface inherits from the IUnknown interface.
Methods
The ID3DDestructionNotifier interface has these methods.
| ID3DDestructionNotifier::RegisterDestructionCallback Registers a user-defined callback to be invoked on destruction of the object from which this ID3DDestructionNotifier was created. |
| ID3DDestructionNotifier::UnregisterDestructionCallback Unregisters a callback that was registered with RegisterDestructionCallback. |
Remarks
The ID3DDestructionNotifier can be used to track resources which are being unexpectedly released early, or providing a log of object disposal.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 7 [desktop apps | UWP apps] |
| Minimum supported server | Windows Server 2008 R2 [desktop apps | UWP apps] |
| Target Platform | Windows |
| Header | d3dcommon.h |
See also
ID3DDestructionNotifier::RegisterDestructionCallback