函数

__host__ ​cudaError_t cudaPointerGetAttributes ( cudaPointerAttributes* attributes, const void* ptr )

返回有关指定指针的属性。

参数

attributes

- 指定指针的属性

ptr

- 要获取属性的指针

返回值

cudaSuccess, cudaErrorInvalidDevice, cudaErrorInvalidValue

描述

在*attributes中返回指针的属性ptr。如果指针不是在支持统一寻址的上下文中分配、映射或注册的，则返回 cudaErrorInvalidValue。

注意

在 CUDA 11.0 及更高版本中，传递主机指针将会在 cudaPointerAttributes::type 中返回 cudaMemoryTypeUnregistered，并且调用将返回 cudaSuccess。

cudaPointerAttributes 结构定义如下

‎    struct cudaPointerAttributes {
              enum cudaMemoryType 
                  type;
              int device;
              void *devicePointer;
              void *hostPointer;
          }

在此结构中，各个字段的含义如下

• cudaPointerAttributes::type 标识内存类型。它可以是未注册主机内存的 cudaMemoryTypeUnregistered、已注册主机内存的 cudaMemoryTypeHost、设备内存的 cudaMemoryTypeDevice 或托管内存的 cudaMemoryTypeManaged。

• device 是分配ptr所针对的设备。如果ptr的内存类型为 cudaMemoryTypeDevice，则这标识了由ptr引用的内存实际驻留的设备。如果ptr的内存类型为 cudaMemoryTypeHost，则这标识了在进行分配时为当前的设备（如果该设备被取消初始化，则此分配将随该设备的状态一起消失）。

• devicePointer 是设备指针别名，通过该别名可以在当前设备上访问由ptr引用的内存。如果当前设备无法直接访问由ptr引用的内存，则此值为 NULL。

• hostPointer 是主机指针别名，通过该别名可以在主机上访问由ptr引用的内存。如果主机无法直接访问由ptr引用的内存，则此值为 NULL。

注意

• 请注意，如果此调用尝试初始化内部 CUDA RT 状态，则此函数也可能返回 cudaErrorInitializationError、cudaErrorInsufficientDriver 或 cudaErrorNoDevice。

• 请注意，如 cudaStreamAddCallback 所指定，不得从回调中调用任何 CUDA 函数。在这种情况下，可能会（但不保证）返回 cudaErrorNotPermitted 作为诊断信息。

另请参阅

cudaGetDeviceCount, cudaGetDevice, cudaSetDevice, cudaChooseDevice, cudaInitDevice, cuPointerGetAttributes