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

  • Artigo

Defina dados definidos pelo aplicativo como um filho do dispositivo e associe esses dados a um guid definido pelo aplicativo.

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 esse filho do dispositivo. Se pData for NULL, DataSize também deverá ser 0 e todos os dados anteriormente associados ao guid especificado 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 filho com esse método podem ser recuperados com ID3D11DeviceChild::GetPrivateData.

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 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

ID3D11DeviceChild