pub unsafe extern "C" fn openmpt_probe_file_header_without_filesize(
flags: u64,
data: *const c_void,
size: usize,
logfunc: openmpt_log_func,
loguser: *mut c_void,
errfunc: openmpt_error_func,
erruser: *mut c_void,
error: *mut c_int,
error_message: *mut *const c_char
) -> c_intExpand description
\brief Probe the provided bytes from the beginning of a file for supported file format headers to find out whether libopenmpt might be able to open it
\param flags Bit mask of OPENMPT_PROBE_FILE_HEADER_FLAGS_MODULES and OPENMPT_PROBE_FILE_HEADER_FLAGS_CONTAINERS, or OPENMPT_PROBE_FILE_HEADER_FLAGS_DEFAULT. \param data Beginning of the file data. \param size Size of the beginning of the file data. \param logfunc Logging function where warning and errors are written. May be NULL. \param loguser Logging function user context. Used to pass any user-defined data associated with this module to the logging function. \param errfunc Error function to define error behaviour. May be NULL. \param erruser Error function user context. Used to pass any user-defined data associated with this module to the logging function. \param error Pointer to an integer where an error may get stored. May be NULL. \param error_message Pointer to a string pointer where an error message may get stored. May be NULL. \remarks It is recommended to use openmpt_probe_file_header() and provide the acutal file’s size as a parameter if at all possible. libopenmpt can provide more accurate answers if the filesize is known. \remarks It is recommended to provide openmpt_probe_file_header_get_recommended_size() bytes of data for data and size. If the file is smaller, only provide the filesize amount and set size to the file’s size. \remarks openmpt_could_open_probability2() provides a more elaborate interface that might be required for special use cases. It is recommended to use openmpt_probe_file_header() though, if possible. \retval OPENMPT_PROBE_FILE_HEADER_RESULT_SUCCESS The file will most likely be supported by libopenmpt. \retval OPENMPT_PROBE_FILE_HEADER_RESULT_FAILURE The file is not supported by libopenmpt. \retval OPENMPT_PROBE_FILE_HEADER_RESULT_WANTMOREDATA An answer could not be determined with the amount of data provided. \retval OPENMPT_PROBE_FILE_HEADER_RESULT_ERROR An internal error occurred. \sa openmpt_probe_file_header_get_recommended_size() \sa openmpt_probe_file_header() \sa openmpt_probe_file_header_from_stream() \sa openmpt_could_open_probability2() \since 0.3.0