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

# OpenSharedHandle

> Abre um identificador para recursos compartilhados, heaps compartilhados e fences compartilhados, usando HANDLE e REFIID.

Abre um identificador para recursos compartilhados, heaps compartilhados e fences compartilhados, usando HANDLE e REFIID.

## Sintaxe

```cpp theme={null}
HRESULT OpenSharedHandle(
    HANDLE NTHandle,
    const IID & riid,
    void  ppvObj
)
```

### Parâmetros

*NTHandle \[in]*\
Tipo: HANDLE

O identificador que foi gerado pela chamada para
[ID3D12Device::CreateSharedHandle](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createsharedhandle_public).

*riid*\
Tipo: const IID &

O identificador global exclusivo (**GUID**) de uma das seguintes interfaces:

<ul>
  <li>
    [ID3D12Heap](/pt-BR/reference/graphics/d3d12/interfaces/id3d12heap/id3d12heap_public)
  </li>

  <li>
    [ID3D12Resource](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12Resource/id3d12resource_xs)
  </li>

  <li>
    [ID3D12Fence](/pt-BR/reference/graphics/d3d12/interfaces/id3d12fence/id3d12fence_public)
  </li>
</ul>

O **REFIID**, ou **GUID**, da interface pode ser obtido usando a macro \_\_uuidof().
Por exemplo, \_\_uuidof(ID3D12Heap) obterá o **GUID** da interface para um recurso.

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

Um ponteiro para um bloco de memória que recebe um ponteiro para uma das seguintes interfaces:

<ul>
  <li>
    [ID3D12Heap](/pt-BR/reference/graphics/d3d12/interfaces/id3d12heap/id3d12heap_public)
  </li>

  <li>
    [ID3D12Resource](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12Resource/id3d12resource_xs)
  </li>

  <li>
    [ID3D12Fence](/pt-BR/reference/graphics/d3d12/interfaces/id3d12fence/id3d12fence_public)
  </li>
</ul>

### Valor retornado

Tipo: HRESULT

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

## Requisitos

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

## Confira também

[ID3D12Device](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device)

[Sistemas com vários adaptadores](https://learn.microsoft.com/en-us/windows/win32/direct3d12/multi-engine)


## Related topics

- [OpenSharedHandleByName](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_opensharedhandlebyname_public.md)
- [IGameInputDispatcher::OpenWaitHandle](/pt-BR/reference/input/gameinput/interfaces/IGameInputDispatcher/methods/igameinputdispatcher_openwaithandle.md)
- [SHARED_SHAPE_CONTEXTS](/pt-BR/reference/audio/acphal/structs/shared_shape_contexts.md)
- [Delete Shared Group](/api-reference/shared-group-data/delete-shared-group.md)
- [Create Shared Group](/api-reference/shared-group-data/create-shared-group.md)