What's the replacement for cuModuleGetSurfRef and cuModuleGetTexRef?

Question

CUDA 12 indicates that these two functions:

CUresult cuModuleGetSurfRef (CUsurfref* pSurfRef, CUmodule hmod, const char* name);
CUresult cuModuleGetTexRef (CUtexref* pTexRef, CUmodule hmod, const char* name);

which obtain a reference to surface or a texture, respectively, from a loaded module - are deprecated.

What are they deprecated in favor of? Are surfaces and textures in modules to be accessed differently? Will they be entirely out of modules? If it's the latter, how would one work with them using the CUDA driver API?

There is no replacement. Texture and surface references are being removed from CUDA in favour of objects — talonmies, Feb 19 '23 at 12:00

score 1 · Answer 1 · answered Feb 19 '23 at 12:30

So, based on @talonmies' comment, it seems the "replacement" are "texture objects" and "surface objects". The main difference - as far as is evident in the API - is that the new "objects" have less API calls, which take richer descriptors. Thus, the user sets fields themselves, and does not need the large number of cuTexRefGetXXXX and cuTexRefSetXXXX calls. There are also "tensor map objects", appearing with Compute Capability 9.0 and later.

What's the replacement for cuModuleGetSurfRef and cuModuleGetTexRef?

1 Answers1