Function cudaStreamBeginCaptureToGraph

pub unsafe extern "C" fn cudaStreamBeginCaptureToGraph(
    stream: cudaStream_t,
    graph: cudaGraph_t,
    dependencies: *const cudaGraphNode_t,
    dependencyData: *const cudaGraphEdgeData,
    numDependencies: usize,
    mode: cudaStreamCaptureMode,
) -> cudaError_t

\brief Begins graph capture on a stream to an existing graph

Begin graph capture on \p stream. When a stream is in capture mode, all operations pushed into the stream will not be executed, but will instead be captured into \p graph, which will be returned via ::cudaStreamEndCapture.

Capture may not be initiated if \p stream is ::cudaStreamLegacy. Capture must be ended on the same stream in which it was initiated, and it may only be initiated if the stream is not already in capture mode. The capture mode may be queried via ::cudaStreamIsCapturing. A unique id representing the capture sequence may be queried via ::cudaStreamGetCaptureInfo.

If \p mode is not ::cudaStreamCaptureModeRelaxed, ::cudaStreamEndCapture must be called on this stream from the same thread.

\note Kernels captured using this API must not use texture and surface references. Reading or writing through any texture or surface reference is undefined behavior. This restriction does not apply to texture and surface objects.

\param stream - Stream in which to initiate capture. \param graph - Graph to capture into. \param dependencies - Dependencies of the first node captured in the stream. Can be NULL if numDependencies is 0. \param dependencyData - Optional array of data associated with each dependency. \param numDependencies - Number of dependencies. \param mode - Controls the interaction of this capture sequence with other API calls that are potentially unsafe. For more details see ::cudaThreadExchangeStreamCaptureMode.

\return ::cudaSuccess, ::cudaErrorInvalidValue \notefnerr

\sa ::cudaStreamCreate, ::cudaStreamIsCapturing, ::cudaStreamEndCapture, ::cudaThreadExchangeStreamCaptureMode