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

# GetGPUVirtualAddress

> 此方法返回缓冲区资源的 GPU 虚拟地址。

此方法返回缓冲区资源的 GPU 虚拟地址。

## 语法

```cpp theme={null}
D3D12_GPU_VIRTUAL_ADDRESS GetGPUVirtualAddress(
)
```

### 参数

### 返回值

类型：D3D12\_GPU\_VIRTUAL\_ADDRESS

此方法返回 GPU 虚拟地址。
D3D12\_GPU\_VIRTUAL\_ADDRESS 是 UINT64 的 typedef 同义词。

## 备注

此方法仅对缓冲区资源有用，对所有纹理资源都将返回零。

有关使用 GPU 虚拟地址的详细信息，请参阅[间接绘制](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/indirect-drawing)。

#### 示例

[D3D1211on12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/working-samples) 示例按如下方式使用 **ID3D12Resource::GetGPUVirtualAddress**：

```cpp theme={null}
// Initialize the vertex buffer view.
m_vertexBufferView.BufferLocation = m_vertexBuffer->GetGPUVirtualAddress();
m_vertexBufferView.StrideInBytes = sizeof(Vertex);
m_vertexBufferView.SizeInBytes = vertexBufferSize;

```

请参阅 [D3D12 参考中的示例代码](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/notes-on-example-code)。

<div class="code" />

## 要求

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

## 另请参阅

[ID3D12Resource](/reference/graphics/d3d12_xs/interfaces/ID3D12Resource/id3d12resource_xs)


## Related topics

- [ApuIsVirtualAddressValid](/zh-CN/reference/audio/apu/functions/apuisvirtualaddressvalid.md)
- [ApuMapVirtualAddress](/zh-CN/reference/audio/apu/functions/apumapvirtualaddress.md)
- [D3D12_GPU_VIRTUAL_ADDRESS_RANGE](/zh-CN/reference/graphics/d3d12/structs/d3d12_gpu_virtual_address_range_public.md)
- [D3D12_GPU_VIRTUAL_ADDRESS_AND_STRIDE](/zh-CN/reference/graphics/d3d12/structs/d3d12_gpu_virtual_address_and_stride_public.md)
- [D3D12_GPU_VIRTUAL_ADDRESS_RANGE_AND_STRIDE](/zh-CN/reference/graphics/d3d12/structs/d3d12_gpu_virtual_address_range_and_stride_public.md)
