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

# GetPrivateData

> Obtém dados definidos pelo aplicativo de um objeto de dispositivo.

Obtém dados definidos pelo aplicativo de um objeto de dispositivo.

## Sintaxe

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

### Parâmetros

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

O **GUID** associado aos dados.

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

Um ponteiro para uma variável que, na entrada, contém o tamanho, em bytes, do buffer para o qual <i>pData</i> aponta e, na saída, contém o tamanho, em bytes, da quantidade de dados que **GetPrivateData** recuperou.

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

Um ponteiro para um bloco de memória que recebe os dados do objeto de dispositivo se <i>pDataSize</i> apontar para um valor que especifica um buffer grande o suficiente para armazenar os dados.

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

Se os dados retornados forem um ponteiro para um [IUnknown](https://learn.microsoft.com/en-us/windows/desktop/api/unknwn/nn-unknwn-iunknown), ou uma de suas classes derivadas, definido anteriormente por SetPrivateDataInterface, essa interface terá sua contagem de referências incrementada antes que os dados privados sejam retornados.

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