6.22. Direct3D 11 互操作性

本节介绍 CUDA 运行时应用程序编程接口的 Direct3D 11 互操作性功能。请注意，Direct3D 11 资源的映射是使用图形 API 不可知、资源映射接口执行的，该接口在图形互操作性中进行了描述。

枚举

enum cudaD3D11DeviceList

函数

__host__ ​cudaError_t cudaD3D11GetDevice ( int* device, IDXGIAdapter* pAdapter )
获取适配器的设备编号。
__host__ ​cudaError_t cudaD3D11GetDevices ( unsigned int* pCudaDeviceCount, int* pCudaDevices, unsigned int  cudaDeviceCount, ID3D11Device* pD3D11Device, cudaD3D11DeviceList deviceList )
获取与 Direct3D 11 设备对应的 CUDA 设备。
__host__ ​cudaError_t cudaGraphicsD3D11RegisterResource ( cudaGraphicsResource** resource, ID3D11Resource* pD3DResource, unsigned int  flags )
注册 Direct3D 11 资源以供 CUDA 访问。

枚举

enum cudaD3D11DeviceList

与 D3D11 设备对应的 CUDA 设备

值
cudaD3D11DeviceListAll = 1
D3D11 设备使用的所有 GPU 的 CUDA 设备
cudaD3D11DeviceListCurrentFrame = 2
D3D11 设备在其当前渲染帧中使用的 GPU 的 CUDA 设备
cudaD3D11DeviceListNextFrame = 3
D3D11 设备在下一帧中将要使用的 GPU 的 CUDA 设备

函数

__host__ ​cudaError_t cudaD3D11GetDevice ( int* device, IDXGIAdapter* pAdapter )
获取适配器的设备编号。
参数
device
- 返回与 pAdapter 对应的设备
pAdapter
- 用于获取设备的 D3D11 适配器
返回值

cudaSuccess, cudaErrorInvalidValue, cudaErrorUnknown

描述

在...中返回*device与适配器对应的 CUDA 兼容设备pAdapter从 IDXGIFactory::EnumAdapters 获取。只有当适配器上的设备pAdapter与 CUDA 兼容时，此调用才会成功。

注意

请注意，此函数也可能返回来自先前异步启动的错误代码。

另请参阅

cudaGraphicsUnregisterResource, cudaGraphicsMapResources, cudaGraphicsSubResourceGetMappedArray, cudaGraphicsResourceGetMappedPointer, cuD3D11GetDevice

__host__ ​cudaError_t cudaD3D11GetDevices ( unsigned int* pCudaDeviceCount, int* pCudaDevices, unsigned int  cudaDeviceCount, ID3D11Device* pD3D11Device, cudaD3D11DeviceList deviceList )
获取与 Direct3D 11 设备对应的 CUDA 设备。
参数
pCudaDeviceCount
- 返回的与pD3D11Device
对应的 CUDA 设备数量
pCudaDevicespD3D11Device
- 返回的与
cudaDeviceCount对应的 CUDA 设备数量
pD3D11Device
- 输出设备数组的大小
- 要查询 CUDA 设备的 Direct3D 11 设备
deviceList
返回值

cudaSuccess, cudaErrorNoDevice, cudaErrorUnknown

描述

在...中返回*pCudaDeviceCount与 Direct3D 11 设备对应的 CUDA 兼容设备的数量pD3D11Device。也在...中返回*pCudaDevices最多- 返回的与与 Direct3D 11 设备对应的 CUDA 兼容设备pD3D11Device.

如果用于渲染pDevice的 GPU 中有任何一个不支持 CUDA，则调用将返回 cudaErrorNoDevice。

注意

请注意，此函数也可能返回来自先前异步启动的错误代码。

另请参阅

cudaGraphicsUnregisterResource, cudaGraphicsMapResources, cudaGraphicsSubResourceGetMappedArray, cudaGraphicsResourceGetMappedPointer, cuD3D11GetDevices

__host__ ​cudaError_t cudaGraphicsD3D11RegisterResource ( cudaGraphicsResource** resource, ID3D11Resource* pD3DResource, unsigned int  flags )
注册 Direct3D 11 资源以供 CUDA 访问。
参数
resource
- 指向返回的资源句柄的指针
pD3DResource
- 要注册的 Direct3D 资源
flags
- 资源注册的参数
返回值

cudaSuccess, cudaErrorInvalidDevice, cudaErrorInvalidValue, cudaErrorInvalidResourceHandle, cudaErrorUnknown

描述

注册 Direct3D 11 资源pD3DResource以供 CUDA 访问。

如果此调用成功，则应用程序将能够映射和取消映射此资源，直到通过 cudaGraphicsUnregisterResource() 取消注册为止。此外，在成功时，此调用将增加内部引用计数pD3DResource。当通过 cudaGraphicsUnregisterResource() 取消注册此资源时，此引用计数将递减。

此调用可能具有较高的开销，不应在交互式应用程序中每帧调用。

...的类型pD3DResource必须是以下类型之一。

  • ID3D11Buffer：可以通过设备指针访问

  • ID3D11Texture1D：纹理的各个子资源可以通过数组访问

  • ID3D11Texture2D：纹理的各个子资源可以通过数组访问

  • ID3D11Texture3D：纹理的各个子资源可以通过数组访问

...flags参数可用于在注册时指定其他参数。此参数的有效值是

并非上述类型的所有 Direct3D 资源都可以用于与 CUDA 的互操作性。以下是一些限制。

  • 主渲染目标可能无法在 CUDA 中注册。

  • 格式不是 1、2 或 4 通道 8、16 或 32 位整数或浮点数据的纹理无法共享。

  • 深度或模板格式的表面无法共享。

支持的 DXGI 格式的完整列表如下。为了简洁起见，符号 A_{B,C,D} 表示 A_B、A_C 和 A_D。

  • DXGI_FORMAT_A8_UNORM

  • DXGI_FORMAT_B8G8R8A8_UNORM

  • DXGI_FORMAT_B8G8R8X8_UNORM

  • DXGI_FORMAT_R16_FLOAT

  • DXGI_FORMAT_R16G16B16A16_{FLOAT,SINT,SNORM,UINT,UNORM}

  • DXGI_FORMAT_R16G16_{FLOAT,SINT,SNORM,UINT,UNORM}

  • DXGI_FORMAT_R16_{SINT,SNORM,UINT,UNORM}

  • DXGI_FORMAT_R32_FLOAT

  • DXGI_FORMAT_R32G32B32A32_{FLOAT,SINT,UINT}

  • DXGI_FORMAT_R32G32_{FLOAT,SINT,UINT}

  • DXGI_FORMAT_R32_{SINT,UINT}

  • DXGI_FORMAT_R8G8B8A8_{SINT,SNORM,UINT,UNORM,UNORM_SRGB}

  • DXGI_FORMAT_R8G8_{SINT,SNORM,UINT,UNORM}

  • DXGI_FORMAT_R8_{SINT,SNORM,UINT,UNORM}

如果pD3DResource类型不正确或已注册，则返回 cudaErrorInvalidResourceHandle。如果pD3DResource无法注册，则返回 cudaErrorUnknown。

注意

请注意，此函数也可能返回来自先前异步启动的错误代码。

另请参阅

cudaGraphicsUnregisterResource, cudaGraphicsMapResources, cudaGraphicsSubResourceGetMappedArray, cudaGraphicsResourceGetMappedPointer, cuGraphicsD3D11RegisterResource