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

# SetPrivateData

> Establece datos definidos por la aplicación en un objeto de dispositivo y asocia esos datos a un GUID definido por la aplicación.

Establece datos definidos por la aplicación en un objeto de dispositivo y asocia esos datos a un **GUID** definido por la aplicación.

## Sintaxis

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

### Parámetros

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

El **GUID** que se va a asociar a los datos.

*DataSize \[in]*\
Tipo: UINT

El tamaño en bytes de los datos.

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

Un puntero a un bloque de memoria que contiene los datos que se van a almacenar con este objeto de dispositivo. Si *pData* es **NULL**, *DataSize* también debe ser 0 y todos los datos que se hubieran asociado previamente al **GUID** especificado en *guid* se destruirán.

### Valor devuelto

Tipo: HRESULT

Este método devuelve uno de los [códigos de retorno de Direct3D 12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues).

## Comentarios

En lugar de usar el esquema de nomenclatura de objetos de depuración de Direct3D 11, que consiste en llamar a **ID3D12Object::SetPrivateData** usando **WKPDID\_D3DDebugObjectName** con un nombre ASCII,
llame a [ID3D12Object::SetName](https://docs.xbox.com/es/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setname_public.md) con un nombre UNICODE.

## Requisitos

**Encabezado:** d3d12\_xs.h o d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib o d3d12\_x.lib\
**Plataformas compatibles**: consolas XBOX Series y familia XBOX One

## Consulte también

[ID3D12Object](https://docs.xbox.com/es/reference/graphics/d3d12_xs/interfaces/ID3D12Object/id3d12object.md)


## Related topics

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