Método IDXGIObject::SetPrivateData (dxgi.h)
Define dados definidos pelo aplicativo para o objeto e associa esses dados a um GUID.
Sintaxe
HRESULT SetPrivateData(
[in] REFGUID Name,
UINT DataSize,
[in] const void *pData
);
Parâmetros
[in] Name
Tipo: REFGUID
Um GUID que identifica os dados. Use esse GUID em uma chamada para GetPrivateData para obter os dados.
DataSize
Tipo: UINT
O tamanho dos dados do objeto.
[in] pData
Tipo: const void*
Um ponteiro para os dados do objeto.
Valor retornado
Tipo: HRESULT
Retorna um dos valores de DXGI_ERROR .
Comentários
SetPrivateData faz uma cópia dos dados especificados e os armazena com o objeto .
Os dados privados que SetPrivateData armazena no objeto ocupam o mesmo espaço de armazenamento que os dados privados armazenados por objetos Direct3D associados (por exemplo, por um dispositivo Microsoft Direct3D 11 por meio de ID3D11Device::SetPrivateData ou por um dispositivo filho Direct3D 11 por meio de ID3D11DeviceChild::SetPrivateData).
A camada de depuração relata vazamentos de memória gerando uma lista de ponteiros de interface de objeto junto com seus nomes amigáveis. O nome amigável padrão é "<sem nome>". Você pode definir o nome amigável para que possa determinar se o ponteiro da interface de objeto correspondente causou o vazamento. Para definir o nome amigável, use o método SetPrivateData e o conhecido GUID de dados privados (WKPDID_D3DDebugObjectName) que está em D3Dcommon.h. Por exemplo, para dar a pContext um nome amigável de Meu nome, use o seguinte código:
static const char c_szName[] = "My name";
hr = pContext->SetPrivateData( WKPDID_D3DDebugObjectName, sizeof( c_szName ) - 1, c_szName );
Você pode usar WKPDID_D3DDebugObjectName para rastrear vazamentos de memória e entender as características de desempenho de seus aplicativos. Essas informações são refletidas na saída da camada de depuração relacionada a vazamentos de memória (ID3D11Debug::ReportLiveDeviceObjects) e com o rastreamento de eventos do Windows que adicionamos ao Windows 8.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | dxgi.h |
| Biblioteca | DXGI.lib |