Function nvfbc_sys::NvFBCToSysGrabFrame

pub unsafe extern "C" fn NvFBCToSysGrabFrame(
    sessionHandle: NVFBC_SESSION_HANDLE,
    pParams: *mut NVFBC_TOSYS_GRAB_FRAME_PARAMS
) -> NVFBCSTATUS

\brief Captures a frame to a buffer in system memory.

This function triggers a frame capture to a buffer in system memory that was registered with the ToSysSetUp() API call.

Note that it is possible that the resolution of the desktop changes while capturing frames. This should be transparent for the application.

When the resolution changes, the capture session is recreated using the same parameters, and necessary buffers are re-allocated. The frame counter is not reset.

An application can detect that the resolution changed by comparing the dwByteSize member of the ::NVFBC_FRAME_GRAB_INFO against a previous frame and/or dwWidth and dwHeight.

During a change of resolution the capture is paused even in asynchronous mode.

\param [in] sessionHandle FBC session handle. \param [in] pParams ::NVFBC_TOSYS_GRAB_FRAME_PARAMS

\return ::NVFBC_SUCCESS \n ::NVFBC_ERR_INVALID_HANDLE \n ::NVFBC_ERR_API_VERSION \n ::NVFBC_ERR_BAD_REQUEST \n ::NVFBC_ERR_CONTEXT \n ::NVFBC_ERR_INVALID_PTR \n ::NVFBC_ERR_INTERNAL \n ::NVFBC_ERR_X \n ::NVFBC_ERR_MUST_RECREATE \n \see NvFBCCreateCaptureSession \n \see NvFBCToSysSetUp