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

# GetPrivateData

> Obtiene datos definidos por la aplicación de un objeto de dispositivo.

Obtiene datos definidos por la aplicación de un objeto de dispositivo.

## Sintaxis

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

### Parámetros

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

El **GUID** asociado a los datos.

*pDataSize \[in, out]*\
Tipo: UINT \*

Un puntero a una variable que en la entrada contiene el tamaño, en bytes, del búfer al que apunta *pData* y que en la salida contiene el tamaño, en bytes, de la cantidad de datos que **GetPrivateData** recuperó.

*pData \[out, optional]*\
Tipo: void \*

Un puntero a un bloque de memoria que recibe los datos del objeto de dispositivo si *pDataSize* apunta a un valor que especifica un búfer lo suficientemente grande como para contener los datos.

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

Si los datos devueltos son un puntero a una interfaz [IUnknown](https://learn.microsoft.com/en-us/windows/desktop/api/unknwn/nn-unknwn-iunknown), o a una de sus clases derivadas, que se estableció previamente mediante SetPrivateDataInterface, el recuento de referencias de esa interfaz se incrementará antes de que se devuelvan los datos privados.

## 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)
- [SetPrivateData](https://docs.xbox.com/es/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setprivatedata_public.md)
- [SetPrivateDataInterface](https://docs.xbox.com/es/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setprivatedatainterface_public.md)
- [Get Shared Group Data](https://docs.xbox.com/api-reference/shared-group-data/get-shared-group-data.md)
- [Get User Data](https://docs.xbox.com/api-reference/player-data-management/get-user-data.md)