Compartilhar via


Método ID3D11Device::SetPrivateData (d3d11.h)

Defina dados para um dispositivo e associe esses dados a um guid.

Sintaxe

HRESULT SetPrivateData(
  [in]           REFGUID    guid,
  [in]           UINT       DataSize,
  [in, optional] const void *pData
);

Parâmetros

[in] guid

Tipo: REFGUID

Guid associado aos dados.

[in] DataSize

Tipo: UINT

Tamanho dos dados.

[in, optional] pData

Tipo: const void*

Ponteiro para os dados a serem armazenados com este dispositivo. Se pData for NULL, DataSize também deverá ser 0 e todos os dados associados anteriormente ao guid serão destruídos.

Retornar valor

Tipo: HRESULT

Esse método retorna um dos seguintes códigos de retorno do Direct3D 11.

Comentários

Os dados armazenados no dispositivo com esse método podem ser recuperados com ID3D11Device::GetPrivateData.

Os dados e o conjunto de guid com esse método normalmente serão definidos pelo aplicativo.

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 do objeto correspondente causou o vazamento. Para definir o nome amigável, use o método SetPrivateData e o GUID 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 );

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho d3d11.h
Biblioteca D3D11.lib

Confira também

ID3D11Device