Interface ID3DDestructionNotifier (d3dcommon.h)

ID3DDestructionNotifier est une interface que vous pouvez utiliser pour vous inscrire aux rappels lorsqu’un objet nano-COM Direct3D est détruit.

Pour acquérir une instance de cette interface, appelez sur un objet Direct3D avec l’IID de ID3DDestructionNotifier.

L’utilisation d’ID3DDestructionNotifier au lieu de ID3D12Object::SetPrivateDataInterface ou direct3D 11 équivalents fournit des garanties plus fortes quant à l’ordre de destruction. Avec ID3DDestructionNotifier, les relations implicites, telles qu’un ID3D11View contenant une référence à son ID3D11Resource sous-jacent, sont garanties comme valides et que l’objet référencé (ici, l’ID3D11Object) est toujours actif lorsque le rappel de destruction est appelé. Avec ID3D12Object::SetPrivateDataInterface, les références implicites peuvent être libérées avant l’appel du rappel de destruction.

Il n’est pas sûr d’accéder à l’objet en cours de destruction pendant le rappel.

Héritage

L’interface ID3DDestructionNotifier hérite de l’interface IUnknown.

Méthodes

L’interface ID3DDestructionNotifier a ces méthodes.

ID3DDestructionNotifier::RegisterDestructionCallback Inscrit un rappel défini par l’utilisateur à appeler lors de la destruction de l’objet à partir duquel cet ID3DDestructionNotifier a été créé.
ID3DDestructionNotifier::UnregisterDestructionCallback Annule l’inscription d’un rappel qui a été inscrit auprès de RegisterDestructionCallback.

Remarques

L’ID3DDestructionNotifier peut être utilisé pour suivre les ressources qui sont libérées de manière inattendue ou pour fournir un journal de suppression d’objets.

Configuration requise

Client minimal pris en charge	Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	d3dcommon.h

Voir aussi

ID3DDestructionNotifier::RegisterDestructionCallback

ID3DDestructionNotifier::UnregisterDestructionCallback

Interfaces de version courantes