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

# OpenExistingHeapFromAddress

> 从地址在系统内存中创建一个专用诊断堆。即使在发生 GPU 故障或设备已移除的情况下，所创建的堆也可以保持存在。

从地址在系统内存中创建一个专用诊断堆。即使在发生 GPU 故障或设备已移除的情况下，所创建的堆也可以保持存在。

## 语法

```cpp theme={null}
HRESULT OpenExistingHeapFromAddress(
    const void  pAddress,
    const IID & riid,
    void  ppvHeap
)
```

### 参数

*pAddress \[in]*<br />类型：const void \*

用于创建堆的地址。

*riid*<br />类型：const IID &

堆接口 ([ID3D12Heap](/reference/graphics/d3d12/interfaces/id3d12heap/id3d12heap_public)) 的全局唯一标识符 (**GUID**)。

可以使用 **\_\_uuidof()** 宏获取堆接口的 **REFIID** 或 **GUID**。例如，**\_\_uuidof(ID3D12Heap)** 将检索堆接口的 **GUID**。

*ppvHeap \[out]*<br />类型：void \*\*

[SAL](https://learn.microsoft.com/en-us/visualstudio/code-quality/annotating-function-parameters-and-return-values?view=vs-2015\&preserve-view=true)：<code>*COM\_Outptr*</code>

指向内存块的指针。成功时，D3D12 运行时会将指向新打开堆的指针写入该内存块。指针的类型取决于提供的 **riid** 参数。

### 返回值

类型：HRESULT

如果没有足够的内存来打开现有堆，则此方法返回 **E\_OUTOFMEMORY**。有关其他可能的返回值，请参阅 [Direct3D 12 返回代码](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues)。

## 备注

堆是在系统内存中创建的，并允许 CPU 访问。它包装整个 VirtualAlloc 区域。

堆可用于放置资源和保留资源，与其他堆一样正交。基于无法由应用程序选择的标志，可能仍然存在限制。

## 要求

**头文件：** d3d12\_xs.h 或 d3d12\_x.h<br />**库：** d3d12\_xs.lib 或 d3d12\_x.lib<br />**支持的平台**：XBOX Series 主机和 XBOX One 系列

## 另请参阅

[ID3D12Device3 接口](/reference/graphics/d3d12_x/interfaces/id3d12device3/id3d12device3)


## Related topics

- [OpenExistingHeapFromFileMapping](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device3/methods/id3d12device3_openexistingheapfromfilemapping_public.md)
- [D3D12_FEATURE_DATA_EXISTING_HEAPS](/zh-CN/reference/graphics/d3d12/structs/d3d12_feature_data_existing_heaps_public.md)
- [OpenSharedHandle](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_opensharedhandle_public.md)
- [XMemCreateWin32Heap](/zh-CN/reference/system/xmem/functions/xmemcreatewin32heap.md)
- [XblNetworkAddressTranslationSetting](/zh-CN/reference/live/xsapi-c/multiplayer_c/enums/xblnetworkaddresstranslationsetting.md)