7.2.3.1 LZNV SDK MFC App File Contents


   7.2.3.1 Function LZNV Encode File


LZNV_Encode_File is a sample function that performs file compression without the need of any prior buffer manipulation, using the LZNV DLL Object


/// \brief      LZNV_Encode_File performs a straight forward file compression without the need of any prior buffer manipulation.

/// \note       The function will perform internal buffering. If you want to perform your own buffering, please use LZNV_Encode_File_wBuffer.

/// \param[in]  _encoding_method: One of the methods _LZNV_ULTRAFAST_COMPRESSION to _LZNV_BETTER_COMPRESSION or _LZNV_HUFFMAN_COMPRESSION to _LZNV_RLE64_COMPRESSION.

/// \param[in]  _memory_level: The working size of the LZ algorithm. _LZNV_BUFFER_SIZE_256KB_INDX to _LZNV_BUFFER_SIZE_16MB_INDX.

/// \param[in]  _wchr_filename_to_compress: Input file path to compress. Unicode WCHAR.

/// \param[in]  _wchr_output_filename: Output file path to compress. Unicode WCHAR.

/// \return     returns NO_ERROR (0) in case of no errors or one of the error codes defined in LZNV_Defines.h header file

///             possible values:

///             - _LZNV_ERROR_INVALID_COMPRESSION_METHOD      

///             - _LZNV_ERROR_INVALID_BUFFER_SIZE            

///             - _LZNV_ERROR_EXPORTED_MAIN_FUNC_NOT_FOUND    

///             - _LZNV_ERROR_INVALID_PROCESS_SIZE            

             

int32_t CMFCAppClientDlg::LZNV_Encode_File(const uint8_t _encoding_method, const uint8_t _memory_level, // chunk_size == 0 -> read whole file in memory

                                           const wchar_t* _wchr_filename_to_compress, const wchar_t* _wchr_output_filename)

{

    int32_t _res = 0;


    ASSERT(_p_LZNV_DLL_Main_funct);

    if (!_p_LZNV_DLL_Main_funct) {

        MessageBox(L"LZNV DLL Not Loaded? Aborting...", L"Error", IDOK);

        return 1;

    }


    ASSERT(_wchr_output_filename);

    ASSERT(_wchr_filename_to_compress);

    if ((!_wchr_filename_to_compress) || (!_wchr_output_filename)) {

        MessageBox(L"LZNV DLL passed NULL parameters...", L"Error", IDOK);

        return 1;

    }


    ASSERT(_encoding_method < _LZNV_MAX_LZ_ALGORITHMS);

    ASSERT(_memory_level < _LZNV_MAX_BUFFER_SIZE_INDX);


    {

        LZNV_FILE_COMMAND_PARAMS _lznv_file_commands = { 0 };


        _lznv_file_commands._encoding_method = _encoding_method;

        _lznv_file_commands._memory_level = _memory_level;


        _lznv_file_commands._command_to_execute = _LZNV_COMMAND_ENCODE;

        _lznv_file_commands._cpu_priority_level = _LZNV_NORMAL_PRIORITY_CLASS;


        ASSERT(_wchr_filename_to_compress);

        wcsncpy_s(_lznv_file_commands._source_file_path, _wchr_filename_to_compress, _LZNV_MAXPATH_);


        ASSERT(_wchr_output_filename);

        wcsncpy_s(_lznv_file_commands._target_file_path, _wchr_output_filename, _LZNV_MAXPATH_);


        _res = (*_p_LZNV_DLL_Main_funct)(_lznv_file_commands);

    }


    CString csStrResult;

    csStrResult.Format(L"LZNV DLL returned result = %d", _res);

    m_stEncodeResult.SetWindowText(csStrResult);


    return _res;

}