Functions

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

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

参数

attributes

- Attributes for the specified pointer

ptr

- Pointer to get attributes for

返回

cudaSuccess, cudaErrorInvalidDevice, cudaErrorInvalidValue

描述

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

Note:

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

cudaPointerAttributes 结构体定义如下：

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

In this structure, the individual fields mean

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

• device 是分配 ptr 时所对应的设备。如果 ptr 的内存类型为 cudaMemoryTypeDevice，则此参数标识 ptr 所引用的内存实际所在的设备。如果 ptr 的内存类型为 cudaMemoryTypeHost，则此参数标识分配内存时当前所处的设备（如果该设备被反初始化，那么此分配将随该设备的状态一起消失）。

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

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

Note:

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

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

另请参阅：

cudaGetDeviceCount, cudaGetDevice, cudaSetDevice, cudaChooseDevice, cudaInitDevice, cuPointerGetAttributes