Compartilhar via


Interface ID3DDestructionNotifier (d3dcommon.h)

ID3DDestructionNotifier é uma interface que você pode usar para registrar para retornos de chamada quando um objeto nano-COM Direct3D é destruído.

Para adquirir uma instância dessa interface, chame em um objeto Direct3D com o IID de ID3DDestructionNotifier.

O uso de ID3DestructionNotifier em vez dos equivalentes ID3D12Object::SetPrivateDataInterface ou Direct3D 11 fornece garantias mais fortes sobre a ordem de destruição. Com ID3DDestructionNotifier, relações implícitas, como um ID3D11View que contém uma referência à ID3D11Resource subjacente, têm a garantia de serem válidas e para que o objeto referenciado (aqui, o ID3D11Object) ainda esteja ativo quando o retorno de chamada de destruição for invocado. Com ID3D12Object::SetPrivateDataInterface, as referências implícitas podem ser liberadas antes que o retorno de chamada de destruição seja invocado.

Não é seguro acessar o objeto que está sendo destruído durante o retorno de chamada.

Herança

A interface ID3DestructionNotifier herda da interface IUnknown .

Métodos

A interface ID3DestructionNotifier tem esses métodos.

 
ID3DDestructionNotifier::RegisterDestructionCallback

Registra um retorno de chamada definido pelo usuário a ser invocado na destruição do objeto do qual esse ID3DestructionNotifier foi criado.
ID3DDestructionNotifier::UnregisterDestructionCallback

Cancela o registro de um retorno de chamada que foi registrado com RegisterDestructionCallback.

Comentários

O ID3DDestructionNotifier pode ser usado para rastrear recursos que estão sendo lançados inesperadamente antecipadamente ou fornecendo um log de descarte de objetos.

Requisitos

   
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho d3dcommon.h

Confira também

ID3DDestructionNotifier::RegisterDestructionCallback

ID3DDestructionNotifier::UnregisterDestructionCallback

Interfaces de versão comuns