> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SetPrivateData

> Define dados definidos pelo aplicativo para um objeto de dispositivo e associa esses dados a um GUID definido pelo aplicativo.

Define dados definidos pelo aplicativo para um objeto de dispositivo e associa esses dados a um **GUID** definido pelo aplicativo.

## Sintaxe

```cpp theme={null}
HRESULT SetPrivateData(
    const GUID & guid,
    UINT DataSize,
    const void  pData
)
```

### Parâmetros

*guid \[in]*\
Tipo: const GUID &

O **GUID** a ser associado aos dados.

*DataSize \[in]*\
Tipo: UINT

O tamanho, em bytes, dos dados.

*pData \[in, optional]*\
Tipo: const void \*

Um ponteiro para um bloco de memória que contém os dados a serem armazenados com este objeto de dispositivo. Se <i>pData</i> for **NULL**, <i>DataSize</i> também deverá ser 0, e todos os dados associados anteriormente ao **GUID** especificado em <i>guid</i> serão destruídos.

### Valor retornado

Tipo: HRESULT

Este método retorna um dos [Códigos de retorno do Direct3D 12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues).

## Comentários

Em vez de usar o esquema de nomenclatura de objetos de depuração do Direct3D 11, que chama **ID3D12Object::SetPrivateData** usando **WKPDID\_D3DDebugObjectName** com um nome ASCII,
chame [ID3D12Object::SetName](/pt-BR/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setname_public) com um nome UNICODE.

## Requisitos

**Cabeçalho:** d3d12\_xs.h ou d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib\
**Plataformas compatíveis**: consoles XBOX Series e família XBOX One

## Confira também

[ID3D12Object](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12Object/id3d12object)


## Related topics

- [SetName](/pt-BR/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setname_public.md)
- [SetPrivateDataInterface](/pt-BR/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setprivatedatainterface_public.md)
- [GetPrivateData](/pt-BR/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_getprivatedata_public.md)
- [Update Shared Group Data](/api-reference/shared-group-data/update-shared-group-data.md)
- [Update User Data](/api-reference/player-data-management/update-user-data.md)