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

> 使用 HANDLE 和 REFIID 開啟共用資源、共用堆積和共用柵欄的控制代碼。

使用 HANDLE 和 REFIID 開啟共用資源、共用堆積和共用柵欄的控制代碼。

## 語法

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

### 參數

*NTHandle \[in]*\
類型：HANDLE

呼叫
[ID3D12Device::CreateSharedHandle](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createsharedhandle_public) 所輸出的控制代碼。

*riid*\
類型：const IID &

下列其中一個介面的全域唯一識別碼 (**GUID**)：

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

  <li>
    [ID3D12Resource](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12Resource/id3d12resource_xs)
  </li>

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

介面的 **REFIID** (或 **GUID**) 可以使用 \_\_uuidof() 巨集取得。
例如，\_\_uuidof(ID3D12Heap) 會取得資源介面的 **GUID**。

*ppvObj \[out, optional]*\
類型：void \*\*

記憶體區塊的指標，該區塊會接收下列其中一個介面的指標：

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

  <li>
    [ID3D12Resource](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12Resource/id3d12resource_xs)
  </li>

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

### 傳回值

類型：HRESULT

此方法會傳回其中一個 [Direct3D 12 傳回碼](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues)。

## 需求

**標頭：** d3d12\_xs.h 或 d3d12\_x.h\
**程式庫：** d3d12\_xs.lib 或 d3d12\_x.lib\
**支援的平台**：XBOX Series 主機與 XBOX One 系列

## 另請參閱

[ID3D12Device](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device)

[多介面卡系統](https://learn.microsoft.com/en-us/windows/win32/direct3d12/multi-engine)


## Related topics

- [OpenSharedHandleByName](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_opensharedhandlebyname_public.md)
- [IGameInputDispatcher::OpenWaitHandle](/zh-TW/reference/input/gameinput/interfaces/IGameInputDispatcher/methods/igameinputdispatcher_openwaithandle.md)
- [SHARED_SHAPE_CONTEXTS](/zh-TW/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)