Método IDXGIObject::SetPrivateData (dxgi.h)

  • Artigo

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

Confira também

DXGI Interfaces

IDXGIObject