L_GetFilterInfo

# include“l_bitmap.h”

L_LTFIL_APIL_INT(pFilterName, pFilterInfo, uStructSize)

检索特定筛选器的信息。

参数

L_TCHAR* pFilterName

指向包含筛选器名称的三个字符标识的字符串的指针。该字符串不能为NULL。

pFILTERINFOpFilterInfo

指向FILTERINFO结构将使用筛选器信息更新。该参数不能为NULL。在将该参数传递给函数之前，用户负责为其分配内存。

L_UINTuStructSize

所指向结构的大小(以字节为单位)pFilterInfo，用于版本控制。使用sizeof (FILTERINFO）.

返回

价值 意义
成功 活动很成功。
< 1 发生错误。指返回代码．

评论

要获得特定筛选器的信息，用户应该将筛选器名称的三个字符标识(不区分大小写)传递给pFilterName函数的参数。例如，如果用户传递了“TIF”(或“TIF”或“TIF”)，那么pFilterInfo参数将被更新为LFTIF过滤器的信息，并且pFilterInfo参数的szName成员将是“LFTIF1??”。

如果pFilterName或pFilterInfo参数传递为NULL，函数将失败并返回ERROR_NULL_PTR错误代码。

的值uStructSize如果参数不正确，函数将失败并返回ERROR_INVALID_STRUCT_SIZE错误代码。

当不再需要pFilterInfo指针时，调用L_FreeFilterInfo(pFilterInfo, 1,0)函数释放存储在pFilterInfo参数。

要更新所获得的筛选器的信息，请调用L_SetFilterInfo函数。

要更新过滤器扩展列表，请确保在调用L_FreeFilterInfo函数之前保存并恢复原始过滤器列表。

要获取所有筛选器的信息，请调用L_GetFilterListInfo函数。

必需的dll和库

平台

x64 Win32。

另请参阅

功能

主题

例子

这个例子告诉L_FileInfo函数只检查PCL过滤器中与PCL相关联的通常扩展名的文件。PCL和其他矢量文件的检查很慢。如果我们告诉L_FileInfo只在扩展名与特定文件的常用扩展名列表匹配时才检查这些文件，那么文本或无效文件的检测将加快。

L_INT GetFilterInfoExample (L_VOID)｛L_INT nRet;FILTERINFO FILTERINFO;//获取过滤器信息(包括通常的扩展列表)nRet = L_GetFilterInfo(文本(“PCL”)、&FilterInfo运算符(FILTERINFO));如果(nRet ! =成功)返回nRet;//删除FILTERINFO_CHECKEDBYFILEINFO标志。这将使// L_FileInfo只有当扩展在通常的扩展列表中时才检查这个过滤器FilterInfo。uFlags = FilterInfo。uFlags & ~FILTERINFO_CHECKEDBYFILEINFO;//更新过滤器信息。// Note1:这将影响所有线程!// Note2: L_GetFilterInfo已设置FilterInfo.uStructSize，//所以我不需要手动设置它。如果您手动设置它//填充FilterInfo的所有成员nRet =L_SetFilterInfo(&FilterInfo, 1,0);如果(nRet ! =成功)返回nRet;//释放与L_GetFilterInfo一起分配的FilterInfo结构(仅限内容!nRet = L_FreeFilterInfo(&FilterInfo, 1,0);如果(nRet ! =成功)返回nRet;返回成功;｝

栅格成像C API帮助
简介
版本历史
开始
应用程序中包含的文件
文档编写者-与您的应用程序包含的文件
LEADTOOLS光栅成像功能
快速参考
教程
函数引用
回调函数
特点概述
附录
188金宝搏的网址客服|支持|联系我们|知识产权公告
©1991 - 2021领德科技有限公司版权所有。