- Deprecated:
- This function is deprecated as of Cuda 3.0.
Returns in
*pPitch and
*pPitchSlice the pitch and Z-slice pitch of the subresource of the mapped Direct3D resource
pResource, which corresponds to
Face and
Level. The values set in
pPitch and
pPitchSlice may change every time that
pResource is mapped.
The pitch and Z-slice pitch values may be used to compute the location of a sample on a surface as follows.
For a 2D surface, the byte offset of the sample at position x, y from the base pointer of the surface is:
y * pitch + (bytes per pixel) * x
For a 3D surface, the byte offset of the sample at position x, y, z from the base pointer of the surface is:
z* slicePitch + y * pitch + (bytes per pixel) * x
Both parameters pPitch and pPitchSlice are optional and may be set to NULL.
If pResource is not of type IDirect3DBaseTexture9 or one of its sub-types or if pResource has not been registered for use with CUDA, then cudaErrorInvalidResourceHandle is returned. If pResource was not registered with usage flags CU_D3D9_REGISTER_FLAGS_NONE, then CUDA_ERROR_INVALID_HANDLE is returned. If pResource is not mapped for access by CUDA then CUDA_ERROR_NOT_MAPPED is returned.
For usage requirements of Face and Level parameters, see cuD3D9ResourceGetMappedPointer().
- Parameters:
-
| pPitch | - Returned pitch of subresource |
| pPitchSlice | - Returned Z-slice pitch of subresource |
| pResource | - Mapped resource to access |
| Face | - Face of resource to access |
| Level | - Level of resource to access |
- Returns:
- CUDA_SUCCESS, CUDA_ERROR_DEINITIALIZED, CUDA_ERROR_NOT_INITIALIZED, CUDA_ERROR_INVALID_CONTEXT, CUDA_ERROR_INVALID_VALUE, CUDA_ERROR_INVALID_HANDLE, CUDA_ERROR_NOT_MAPPED
- Note:
- Note that this function may also return error codes from previous, asynchronous launches.
- See also:
- cuGraphicsSubResourceGetMappedArray
