VPI - Vision Programming Interface

1.2 Release

CUDAInterop.h
Go to the documentation of this file.
1 /*
2  * Copyright 2019-2021 NVIDIA Corporation. All rights reserved.
3  *
4  * NOTICE TO LICENSEE:
5  *
6  * This source code and/or documentation ("Licensed Deliverables") are
7  * subject to NVIDIA intellectual property rights under U.S. and
8  * international Copyright laws.
9  *
10  * These Licensed Deliverables contained herein is PROPRIETARY and
11  * CONFIDENTIAL to NVIDIA and is being provided under the terms and
12  * conditions of a form of NVIDIA software license agreement by and
13  * between NVIDIA and Licensee ("License Agreement") or electronically
14  * accepted by Licensee. Notwithstanding any terms or conditions to
15  * the contrary in the License Agreement, reproduction or disclosure
16  * of the Licensed Deliverables to any third party without the express
17  * written consent of NVIDIA is prohibited.
18  *
19  * NOTWITHSTANDING ANY TERMS OR CONDITIONS TO THE CONTRARY IN THE
20  * LICENSE AGREEMENT, NVIDIA MAKES NO REPRESENTATION ABOUT THE
21  * SUITABILITY OF THESE LICENSED DELIVERABLES FOR ANY PURPOSE. IT IS
22  * PROVIDED "AS IS" WITHOUT EXPRESS OR IMPLIED WARRANTY OF ANY KIND.
23  * NVIDIA DISCLAIMS ALL WARRANTIES WITH REGARD TO THESE LICENSED
24  * DELIVERABLES, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY,
25  * NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE.
26  * NOTWITHSTANDING ANY TERMS OR CONDITIONS TO THE CONTRARY IN THE
27  * LICENSE AGREEMENT, IN NO EVENT SHALL NVIDIA BE LIABLE FOR ANY
28  * SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, OR ANY
29  * DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
30  * WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
31  * ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
32  * OF THESE LICENSED DELIVERABLES.
33  *
34  * U.S. Government End Users. These Licensed Deliverables are a
35  * "commercial item" as that term is defined at 48 C.F.R. 2.101 (OCT
36  * 1995), consisting of "commercial computer software" and "commercial
37  * computer software documentation" as such terms are used in 48
38  * C.F.R. 12.212 (SEPT 1995) and is provided to the U.S. Government
39  * only as a commercial end item. Consistent with 48 C.F.R.12.212 and
40  * 48 C.F.R. 227.7202-1 through 227.7202-4 (JUNE 1995), all
41  * U.S. Government End Users acquire the Licensed Deliverables with
42  * only those rights set forth herein.
43  *
44  * Any use of the Licensed Deliverables in individual and commercial
45  * software must include, in the user documentation and internal
46  * comments to the code, the above Disclaimer and U.S. Government End
47  * Users Notice.
48  */
49 
56 #ifndef NV_VPI_CUDAINTEROP_H
57 #define NV_VPI_CUDAINTEROP_H
58 
59 #include "Array.h"
60 #include "Event.h"
61 #include "Export.h"
62 #include "Image.h"
63 #include "ImageFormat.h"
64 #include "Status.h"
65 #include "Stream.h"
66 #include "Types.h"
67 #include "Version.h"
68 
69 #include <cuda.h>
70 #include <stdint.h>
71 
77 #ifdef __cplusplus
78 extern "C" {
79 #endif
80 
96 #if NV_VPI_VERSION_API_IS(1, 0)
97 __asm__(".symver vpiImageCreateCUDAMemWrapper,vpiImageCreateCUDAMemWrapper@VPI_1.0");
98 #endif
99 VPI_PUBLIC VPIStatus vpiImageCreateCUDAMemWrapper(const VPIImageData *cudaData, uint32_t flags, VPIImage *img);
100 
119 VPI_PUBLIC VPIStatus vpiImageSetWrappedCUDAMem(VPIImage img, const VPIImageData *hostData);
120 
134 VPI_PUBLIC VPIStatus vpiEventCreateCUDAEventWrapper(CUevent cudaEvent, VPIEvent *event);
135 
158 #if NV_VPI_VERSION_API_IS(1, 0)
159 __asm__(".symver vpiArrayCreateCUDAMemWrapper,vpiArrayCreateCUDAMemWrapper@VPI_1.0");
160 #endif
161 VPI_PUBLIC VPIStatus vpiArrayCreateCUDAMemWrapper(const VPIArrayData *arrayData, uint32_t flags, VPIArray *array);
162 
182 VPI_PUBLIC VPIStatus vpiArraySetWrappedCUDAMem(VPIArray array, const VPIArrayData *arrayData);
183 
203 #if NV_VPI_VERSION_API_IS(1, 0)
204 __asm__(".symver vpiStreamCreateCUDAStreamWrapper,vpiStreamCreateCUDAStreamWrapper@VPI_1.0");
205 #endif
206 VPI_PUBLIC VPIStatus vpiStreamCreateCUDAStreamWrapper(CUstream cudaStream, uint32_t flags, VPIStream *stream);
207 
208 #ifdef __cplusplus
209 }
210 #endif
211  // end of VPI_CUDAInterop
213 
214 #endif /* NV_VPI_CUDAINTEROP_H */
Functions and structures for dealing with VPI arrays.
Functions and structures for dealing with VPI events.
Defines types and functions to handle image formats.
Functions and structures for dealing with VPI images.
Declaration of VPI status codes handling functions.
Declares functions dealing with VPI streams.
Defines all types needed for programming with VPI.
Functions and structures for handling VPI library version.
struct VPIArrayImpl * VPIArray
A handle to an array.
Definition: Types.h:191
Stores information about array characteristics and content.
Definition: Array.h:119
VPIStatus vpiArrayCreateCUDAMemWrapper(const VPIArrayData *arrayData, uint32_t flags, VPIArray *array)
Create an array object by wrapping an existing device (CUDA) memory block.
VPIStatus vpiImageSetWrappedCUDAMem(VPIImage img, const VPIImageData *hostData)
Redefines the wrapped device (CUDA) memory in an existing VPIImage wrapper.
VPIStatus vpiImageCreateCUDAMemWrapper(const VPIImageData *cudaData, uint32_t flags, VPIImage *img)
Create an image object by wrapping around an existing device (CUDA) memory block.
VPIStatus vpiStreamCreateCUDAStreamWrapper(CUstream cudaStream, uint32_t flags, VPIStream *stream)
Wraps an existing cudaStream_t into a VPI stream.
VPIStatus vpiArraySetWrappedCUDAMem(VPIArray array, const VPIArrayData *arrayData)
Redefines the wrapped device (CUDA) memory in an existing VPIArray wrapper.
VPIStatus vpiEventCreateCUDAEventWrapper(CUevent cudaEvent, VPIEvent *event)
Create an event object by wrapping around an existing CUDA CUevent object.
struct VPIEventImpl * VPIEvent
A handle to an event.
Definition: Types.h:203
struct VPIImageImpl * VPIImage
A handle to an image.
Definition: Types.h:215
Stores information about image characteristics and content.
Definition: Image.h:159
VPIStatus
Status codes.
Definition: Status.h:81
struct VPIStreamImpl * VPIStream
A handle to a stream.
Definition: Types.h:209