aview-app 1.0.2

package/aardio/lib/sys/printer.aardio

@@ -0,0 +1,271 @@
+//printer 打印机
+namespace sys;
+
+class printer{
+	ctor( printerName,printerDefaults ){
+		if(!printerName) printerName = default();
+		if(!printerName) return;
+		
+		this.hPrinter = {ptr value};
+		if(!api.OpenPrinter(printerName,this.hPrinter,printerDefaults) ) return;
+		this.hPrinter = this.hPrinter.value;
+		if(!this.hPrinter) return;
+		
+		this.deviceName = printerName;
+		..table.gc(this,"close");
+	};
+	documentProperties = function(param){
+   		var needed = api.DocumentProperties(param[["hwnd"]],this.hPrinter,this.deviceName,,,0);
+		var pDevMode = ..raw.buffer(needed);
+   		if( 1 != api.DocumentProperties(param[["hwnd"]],this.hPrinter,this.deviceName,pDevMode,null,2/*_DM_OUT_BUFFER*/) ){
+   			return;
+   		}
+   	
+   		if(param){
+   			var devMode = ..raw.convert(pDevMode,DEVMODE());
+   			..table.assign(devMode,param);
+			if( 1 != api.DocumentProperties(param[["hwnd"]],this.hPrinter,this.deviceName,pDevMode,devMode,8 | 2/*_DM_IN_BUFFER | _DM_OUT_BUFFER*/) ){
+   				return;
+   			}
+   		}
+		
+   		return pDevMode;
+	};
+	createDevice = function(param){
+		var pDevMode;
+		if(param) pDevMode = this.documentProperties(param);
+		var hdc = topointer( ::Gdi32.CreateDC(null, this.deviceName, null, pDevMode) );
+		var pdc = device(hdc,true);
+		pdc.deviceName = this.deviceName;
+		return pdc;
+	};
+	startDoc = function(docName,dataType,outputFile){
+		return !!api.StartDocPrinter(this.hPrinter,1,{
+				ustring docName = docName : "My Document";
+				ustring outputFile = outputFile;
+				ustring dataType = dataType : "RAW";
+		});
+	};
+	startPage = function(){
+		return !!api.StartPagePrinter(this.hPrinter);
+	};
+	endPage = function(){
+		return !!api.EndPagePrinter(this.hPrinter);
+	};
+	endDoc = function(){
+		return !!api.EndDocPrinter(this.hPrinter);
+	};
+	start = function(printProc,docName,dataType,outputFile){
+		if( this.startDoc(docName,dataType,outputFile) ){
+			if( this.startPage() ){
+				printProc();
+				this.endPage();
+			}
+			this.endDoc();
+		}
+	};
+	write = function(data){
+		var written = {INT len};
+		if( api.WritePrinter(this.hPrinter,data, #data,written) ){
+			return written.len;
+		}
+	};
+	writePack = function(...){
+		var data = ..string.pack(...);
+		var written = {INT len};
+		if( api.WritePrinter(this.hPrinter,data, #data,written) ){
+			return written.len;
+		}
+	};
+	read = function(len=255){
+		var buf = ..raw.buffer(len);
+		var noBytesRead = {INT value};
+		if( api.ReadPrinter(this.hPrinter,buf,len,noBytesRead) )
+			return ..string.left(buf,noBytesRead.value);
+	};
+	close = function(){
+		if(this.hPrinter) {
+			api.ClosePrinter(this.hPrinter);
+			this.hPrinter = null;
+		};
+	}
+}
+
+namespace printer{
+	api = ..raw.loadDll("Winspool.drv");
+	
+	each  = function(flags){
+		var needed = {INT value}
+		var returned = {INT value};
+		if(flags===null) flags = 2/*_PRINTER_ENUM_LOCAL*/;
+		api.EnumPrinters(flags, null, 4, null, 0, needed, returned) ;
+		if(!needed.value) return function(){};
+		
+		var buffer = ..raw.buffer(needed.value)
+		api.EnumPrinters(flags, null, 4, buffer, #buffer, needed, returned) ;
+		
+		var info4 = ..raw.convert(buffer,{
+			struct printers[] = {
+				{
+					ustring printerName;
+					ustring serverName;
+					INT attributes;
+				};
+				length = returned.value;
+			}
+		})
+		
+		var index = 0;
+		return function(){
+			index = index + 1;
+			var printer = info4.printers[index];
+			if(printer) return printer.printerName,printer.serverName,printer.attributes;
+		}
+	}
+	
+	default = function(){
+		var buffer = ..raw.buffer(1024)
+		var length = { INT value = 1024};
+		if(api.GetDefaultPrinter(buffer,length) ) return ..string.fromUnicode(buffer);
+	}
+	
+	setDefault = function(printerName){
+		return !!api.SetDefaultPrinter(printerName);
+	}
+	
+	::Gdi32 := ..raw.loadDll("Gdi32.dll");
+	class device{
+		ctor(hdc,gc){
+			this.hdc = hdc;
+			if(!this.hdc){
+				var printerName = ..sys.printer.default();
+				if(printerName) {
+					return ..sys.printer(printerName).createDevice();
+				}
+			}
+			if(gc)this.gchdc = this.hdc;
+			if(!this.hdc) return;
+		};
+		size = function(){
+			return ::Gdi32.GetDeviceCaps(this.hdc,0x8/*_HORZRES*/),::Gdi32.GetDeviceCaps(this.hdc,0xA/*_VERTRES*/);	
+		};
+		rect = function(){
+			return ::RECT(0,0,this.size());
+		} 
+		dpi = function(){
+			return ::Gdi32.GetDeviceCaps(this.hdc,0x58/*_LOGPIXELSX*/),::Gdi32.GetDeviceCaps(this.hdc,0x5A/*_LOGPIXELSY*/);
+		};
+		reset = function(devMode){
+			::Gdi32.ResetDC(this.hdc,devMode);
+		};
+		startDoc = function(docName,dataType,output,fwType){
+			return 0 < ::Gdi32.StartDoc(this.hdc,{
+					int cbSize = 20;
+					ustring docName = docName : "My Document";
+					ustring output = output;
+					ustring dataType = dataType;
+					INT fwType = fwType;
+			});
+		};
+		startPage = function(){
+			return 0 < ::Gdi32.StartPage(this.hdc);
+		};
+		endPage = function(){
+			return 0 < ::Gdi32.EndPage(this.hdc);
+		};
+		endDoc = function(){
+			return 0 < ::Gdi32.EndDoc(this.hdc); 
+		};
+		start = function(printProc,docName,dataType,output,fwType){
+			if( this.startDoc(docName,dataType,output,fwType) ){
+				if( this.startPage() ){
+					printProc(this.hdc,this.rect());
+					this.endPage();
+				}
+				this.endDoc();
+			}
+		};
+		close = function(){
+			if(this.gchdc){
+				::Gdi32.DeleteDC(this.gchdc);
+				this.gchdc = null;
+				this.hdc = null;
+			}
+		}
+		@{ _topointer = function(){return this.hdc}}
+	}	
+	
+	class DEVMODE{
+		WORD dmDeviceName[32];
+		WORD dmSpecVersion;
+		WORD dmDriverVersion;
+		WORD dmSize;
+		WORD dmDriverExtra;
+		INT dmFields; 
+		word dmOrientation;
+		word dmPaperSize;
+		word dmPaperLength;
+		word dmPaperWidth;
+		word dmScale;
+		word dmCopies;
+		word dmDefaultSource;
+		word dmPrintQuality; 
+		word dmColor;
+		word dmDuplex;
+		word dmYResolution;
+		word dmTTOption;
+		word dmCollate;
+		WORD dmFormName[32];
+		WORD dmLogPixels;
+		INT dmBitsPerPel;
+		INT dmPelsWidth;
+		INT dmPelsHeight;
+		INT dmDisplayFlags;
+		INT dmDisplayFrequency;
+		INT dmICMMethod;
+		INT dmICMIntent;
+		INT dmMediaType;
+		INT dmDitherType;
+		INT dmReserved1;
+		INT dmReserved2; 
+		INT dmPanningWidth;
+		INT dmPanningHeight; 
+	}
+	
+}
+
+/**intellisense()
+sys.printer(.(printerName,printerDefaults) = 打开打印机设备\nprinterName指定打印机名称,省略打开默认打印机\nprinterDefaults可省略
+sys.printer.device(.(hdc) = 创建绘图设备对象\n如果不指定hdc,则自动获取默认打印机绘图设备句柄\n如果参数@2为true,则负责释放参数@1指定的hdc
+sys.printer() = !stdsysprinter.
+sys.printer.device() = !stdsysprinterdc.
+sys.printer.each(flags) = @for printerName,serverName,attributes in sys.printer.each(){
+	__/*遍历系统打印机:\nprinterName为打机机名称,\nserverName为服务名,\nattributes为_PRINTER_ATTRIBUTE_前缀常量*/
+}
+sys.printer.setDefault(__/*名称*/) = 设置默认打印机
+sys.printer.default() = 返回默认打印机名称
+end intellisense**/
+
+/**intellisense(!stdsysprinter)
+documentProperties() = 获取或修改DEVMODE缓冲区指针\n可选在参数中使用任意个键值对重新指定DEVMODE部分字段的值
+createDevice() = 创建绘图设备对象,\n可选在参数中使用任意个键值对重新指定DEVMODE部分字段的值\n!stdsysprinterdc.
+startDoc(docName,dataType,outputFile) = 开始打印文档,所有参数可选\n参数参考API函数StartPagePrinter的说明
+startPage() = 开始打印一个页面
+endPage() = 结束打印一个页面
+endDoc() = 结束打印一个文档
+writePack(__) = 写入一个或多个字节码
+write(__) = 写入字符串
+start(回调函数,文档名,文档类型,输出文件) = 	@.start(\n	function(){\n		__	\n	}\n);
+end intellisense**/
+
+/**intellisense(!stdsysprinterdc)
+reset(__) = 修改打印机设置\n参数应为 sys.printer.documentProperties 函数返回的 DEVMODE 指针
+size() = 返回 2 个返回值，分别为绘图区块的宽，高。
+rect() = 返回一个表示绘图区块的 RECT 结构体\n!rect.
+dpi() = 返回DPI
+startDoc(docName,dataType,output,fwType) = 开始打印文档,所有参数可选\n参数参考 API 函数 StartPage 的说明
+startPage() = 开始打印一个页面
+endPage() = 结束打印一个页面
+endDoc() = 结束打印一个文档
+start(回调函数,文档名,文档类型,输出文件,类型) = @.start(\n	function(hdcPrinter,rc){\n		::Gdi32.TextOut(hdcPrinter,20,20,"测试打印",4);	__/*回调参数 hdcPrinter 为绘图设备上下文句柄（hdc）,\nrc 为绘图区块（ ::RECT 结构体）。*/\n	}\n);
+end intellisense**/

package/aardio/lib/sys/qfe.aardio

@@ -0,0 +1,14 @@
+//qfe 系统补丁
+import com.wmi;
+
+namespace sys;
+
+class qfe{
+	ctor(hotfixId){
+		return ..com.wmi.getProperties("SELECT * FROM Win32_QuickFixEngineering WHERE HotFixID =@hotfixId",{hotfixId=hotfixId} ) 
+	}; 
+}
+
+/**intellisense()
+sys.qfe("KB__") = 返回参数指定 ID 的系统补丁安装信息\n未安装返回 null\n\n inet.installer 支持安装 *.msu 补丁
+end intellisense**/

package/aardio/lib/sys/reg.aardio

@@ -0,0 +1,40 @@
+//reg 注册表
+namespace sys.reg;
+
+setValueEx = function(name,value,size,valueType,path,root){
+	var rkey = {ptr handle}
+	var err = ::Advapi32.RegCreateKeyExW(root: 0x80000001/*_HKEY_CURRENT_USER*/,path
+		,0,/*lpClass*/, 0/*_REG_OPTION_NON_VOLATILE*/,0xF003F/*_KEY_ALL_ACCESS*/,null,rkey,null);
+	
+	if(!err){
+		var res;
+		if( value===null ) res = ::Advapi32.RegDeleteValueW(rkey.handle,name);
+		else res = ::Advapi32.RegSetValueExW( rkey.handle,name,0,valueType,value,size);
+		
+		::Advapi32.RegCloseKey(rkey.handle); 
+		return res == 0;
+	} 
+}
+
+setValue = function(name,value,path,root) {
+	var t = type(value);
+	if( t==="number" ) return setValueEx(name,{INT dw = value },4,4/*_REG_DWORD*/,path,root); 
+	elseif( t==="string"  ) {
+		value = ..string.toUnicode(value);
+		return setValueEx(name,value,#value+2,1/*_REG_SZ*/,path,root); 
+	}
+	elseif( t==="buffer"  ) return setValueEx(name,value,#value,3/*_REG_BINARY*/,path,root); 
+	elseif( value===null ) return setValueEx(name,null,0,0,path,root); 
+	else error("@value 参数类型错误",2)
+};
+
+/**intellisense()
+sys.reg = 简单写注册表\n如果需要更多功能,请改用 win.reg
+sys.reg.setValue( = 写注册表
+sys.reg.setValue(.(name,value,path,root) = 写注册表。\n@name 使用字符串指定值名称（null 或 空串表示默认值），\n@value 可指定数值、字符串、buffer、null\n数值为存为 _REG_DWORD 类型,\n字符串值存为 _REG_SZ 类型,\nbuffer 值存为 _REG_BINARY 类型。,\nnull 值表示删除。\n\n参数 @path 使用字符串指定注册表路径,\n参数 @root 指定注册表根键,省略则默认为 _HKEY_CURRENT_USER
+end intellisense**/
+
+::Advapi32 := ..raw.loadDll("Advapi32.dll");
+/**intellisense(::)
+::Advapi32 = Advapi32.dll 模块\n以下标准库已加载该模块:\ncrypt,process,service,sys,sys.reg,win.reg\n!dllmodule.
+end intellisense**/

package/aardio/lib/sys/run.aardio

@@ -0,0 +1,32 @@
+//run 启动项
+import sys.reg;
+namespace sys;
+
+class run {
+	ctor(taskName){
+		this.taskName = taskName || ..io.splitpath(..io._exepath).name;
+	};
+	delete = function(){
+		if(_STUDIO_INVOKED) return;
+		..sys.reg.setValue(this.taskName,null,"Software\Microsoft\Windows\CurrentVersion\Run\"); 
+	};
+	register = function(arguments,path){
+		if(_STUDIO_INVOKED) return;
+		
+		var path = `"`+ ..io.fullpath(path : ..io._exepath) + `"`; 
+		if(type(arguments)=="string") {
+			path = path +" "+ arguments; 
+		}
+		
+		..sys.reg.setValue(this.taskName,path,"Software\Microsoft\Windows\CurrentVersion\Run\"); 
+	};
+} 
+
+/**intellisense()
+sys.run = 用于为当前用户注册开机启动项，以普通权限启动，\n如果希望以管理权限启动且不出现警告窗口，请改用 sys.runAsTask\n\n建议大家不要滥用此功能，\n用户未在设置中主动设置开机启动，请不要自动添加，\n仅为当前用户添加开机启动，任何时候都不建议设置所有用户开机启动项。\n滥用自动开机只会招致用户反感，或被安全软件清除
+sys.run(.(taskName) = 创建注册与删除开机启动项工具\n可选用 @taskName 参数指定启动项名称，不指定则为当前文件名
+sys.run() = !stdSysRun.
+!stdSysRun.delete() = 删除开机启动项\n在开发环境中此函数不执行操作，仅发布后会生效
+!stdSysRun.register( = 添加开机启动项\n在开发环境中此函数不执行操作，仅发布后会生效
+!stdSysRun.register(.(arguments,path,workDir) = 添加开机启动项\n可选用 @arguments 参数指定启动参数，此参数必须是字符串。\n可选用 @path 参数指定要启动的应用程序路径,省略则为当前应用程序路径
+end intellisense**/

package/aardio/lib/sys/runAsTask.aardio

@@ -0,0 +1,87 @@
+//runAsTask 启动任务
+import process;
+import com;
+
+namespace sys;
+
+class runAsTask{
+	ctor(taskName,description,author){
+		this.taskName = taskName || ..io._exefile;
+		
+		var schedule = ..com.CreateObject("Schedule.Service");
+		schedule.Connect();
+				
+		//https://docs.microsoft.com/en-us/windows/win32/taskschd/taskdefinition	
+		var definition = schedule.NewTask(0); 
+		definition.registrationInfo.Author = author : "Administrator";
+		definition.registrationInfo.Description = description : "";
+		definition.principal.LogonType = schedule.TASK_LOGON_GROUP;
+		definition.principal.GroupId = "Builtin\Administrators"
+		definition.principal.RunLevel = schedule.TASK_RUNLEVEL_HIGHEST; 
+		
+		//https://docs.microsoft.com/en-us/windows/win32/taskschd/tasksettings
+		definition.settings.StartWhenAvailable = true;
+		definition.settings.Enabled = true 
+		definition.settings.Hidden = false
+		definition.settings.DisallowStartIfOnBatteries = false;
+		definition.settings.StopIfGoingOnBatteries = false;
+		definition.settings.MultipleInstances = schedule.TASK_INSTANCES_PARALLEL;
+		definition.settings.AllowHardTerminate = false;
+							
+		definition.settings.RunOnlyIfNetworkAvailable = false;
+		definition.settings.RunOnlyIfIdle = false;
+		definition.settings.AllowDemandStart = true;
+		definition.settings.RestartInterval = "PT1M";
+		definition.settings.RestartCount = 3;
+		definition.settings.ExecutionTimeLimit = "PT0S";
+		
+		var trigger = definition.triggers.Create(schedule.TASK_TRIGGER_LOGON);
+		trigger.Enabled = true;                    
+		trigger.Repetition.StopAtDurationEnd = false;
+		trigger.ExecutionTimeLimit = "PT0S"; 
+		
+		this.definition = definition;
+		this.trigger = trigger;
+		this.schedule = schedule;
+	};
+	get = function(){
+		var task;
+		var root = this.schedule.GetFolder("\") 
+		try{ task = root.GetTask( taskName ); }
+		return task;
+	};
+	delete = function(){
+		if(_STUDIO_INVOKED) return;
+		var root = this.schedule.GetFolder("\") 
+		try{ root.DeleteTask( taskName ); }
+	};
+	register = function(arguments,path,workDir){
+		if(_STUDIO_INVOKED) return;
+		this.delete();
+		
+		var path = ..io.fullpath(path : ..io._exepath);
+		var act = definition.actions.Create( this.schedule.TASK_ACTION_EXEC );
+		act.Path = path;
+		act.Arguments = ..process.joinArguments(arguments);
+		act.WorkingDirectory = workDir || ..io.splitpath(path).dir;
+			
+		var root = this.schedule.GetFolder("\") 
+		return root.RegisterTaskDefinition(this.taskName, this.definition
+			, this.schedule.TASK_CREATE_OR_UPDATE, , , this.schedule.TASK_LOGON_GROUP); 
+	}; 
+}
+
+/**intellisense()
+sys.runAsTask = 用于创建开机启动任务，以管理员权限启动 - 不会出现警告窗口\n\n建议大家不要滥用此功能，\n用户未在设置中主动设置开机启动，请不要自动添加，\n滥用自动开机只会招致用户反感，或被安全软件清除
+sys.runAsTask(.(taskName,description,author) = 创建开机启动任务，\n@taskName：计划任务名称\n@description: 计划任务描述\n@author: 创建者名称，可选参数
+sys.runAsTask() = !stdSysRunAsTask.
+!stdSysRunAsTask.taskName = 任务名。\n调用 register 函数指定有效，默认值为 EXE 文件名
+!stdSysRunAsTask.trigger.Enabled = 可指定一个布尔值以设置是否允许开机启动。\n调用 register 函数指定有效，默认值为 true
+!stdSysRunAsTask.delete() = 删除计划任务
+!stdSysRunAsTask.register(.(arguments,path,workDir) = 添加计划任务\n@arguments：启动参数，该参数必须是字符串。\n@path：启动的应用程序路径,省略则为当前应用程序路径\n@workdir：启动程序工作目录，可选参数
+!stdSysRunAsTask.get() = 返回已注册计划任务。\n返回对象含 Name（名称）,Path（路径） 属性。\n如果未注册返回 null
+end intellisense**/
+
+/**details(说明)
+查看计划任务列表： raw.execute("control","schedtasks");
+end details**/

package/aardio/lib/sys/soundDevice.aardio

@@ -0,0 +1,46 @@
+//soundDevice 声音设备
+import com.lite;
+import com.interface.IKsPropertySet;
+namespace sys.soundDevice;
+ 
+var dll = ..com.lite("dsound.dll")
+
+class DSPROPERTY_DIRECTSOUNDDEVICE_DESCRIPTION_DATA{
+    int dataType;
+    int dataFlow;
+    struct deviceId = ..win.guid();
+    string description;
+    string module;
+    string interface;
+    INT waveDeviceId;
+}
+
+DSPROPSETID_DirectSoundDevice = ..win.guid(0x84624f82, 0x25ec, 0x11d1, 0xa4, 0xd8, 0x0, 0xc0, 0x4f, 0xc2, 0x8a, 0xca);
+
+enum = function(callback){
+
+    var propertySet = dll.createInstance("{11AB3EC0-25EC-11d1-A4D8-00C04FC28ACA}",..com.interface.IKsPropertySet);
+        
+    var proc = function(pdsdd,pv){
+        var dsd = ..raw.convert(pdsdd,DSPROPERTY_DIRECTSOUNDDEVICE_DESCRIPTION_DATA() );
+        dsd.description = ..string.fromto(dsd.description,0,65001);
+        dsd.module = ..string.fromto(dsd.module,0,65001);
+        dsd.interface = ..string.fromto(dsd.interface,0,65001);
+        return callback(dsd.description,dsd.dataFlow,dsd.dataType,dsd.deviceId,dsd.module,dsd.interface,dsd.waveDeviceId);
+    }
+    
+    var dsdd = {
+        pointer callback = ..raw.tostdcall(proc,"bool(pointer pdsdd,pointer pv) ");
+        pointe context;
+    }
+    
+    propertySet.Get( DSPROPSETID_DirectSoundDevice,7/*DSPROPERTY_DIRECTSOUNDDEVICE_ENUMERATE*/,null,0,..raw.buffer(dsdd),..raw.sizeof(dsdd),0)
+    ..com.Release(propertySet);
+    ..raw._release(dsdd.callback);
+}
+
+/**intellisense()
+sys.soundDevice.enum( callback ) = @.enum(\n    function(description,dataFlow,dataType,deviceId,module,interface,waveDeviceId){\n        if( !dataFlow ){\n            __\n        }\n        return true;\n    }\n)	
+_DIRECTSOUNDDEVICE_DATAFLOW_RENDER=@0/*_DIRECTSOUNDDEVICE_DATAFLOW_RENDER*/
+_DIRECTSOUNDDEVICE_DATAFLOW_CAPTURE=@1/*_DIRECTSOUNDDEVICE_DATAFLOW_CAPTURE*/
+end intellisense**/

package/aardio/lib/sys/storage.aardio

@@ -0,0 +1,173 @@
+//storage 存储设备
+import fsys.file;
+import fsys.drives;
+
+namespace sys.storage;
+ 
+queryProperty = function(devicePath){
+    if(devicePath===null){
+        for(i=0;4;1){
+            var p = queryProperty(i);
+            if( p ) return p;
+        }
+        return;
+    }
+    elseif( type(devicePath) == type.number ){
+    	devicePath = ..string.format( "\\.\PhysicalDrive%d",devicePath);
+    }
+    elseif(! ..string.match(devicePath,"\\\\\p\\") ){
+        devicePath = "\\.\" + devicePath;
+    }
+    
+    var file = ..fsys.file(devicePath,0);
+    if (!file) return; 
+    
+    var query = {
+        INT propertyId;//_StorageDeviceProperty
+        INT queryType;//_PropertyStandardQuery
+        BYTE additionalParameters[1];  
+    }
+     
+    var descriptor = {  
+        INT version; 
+        INT size; 
+        BYTE deviceType; 
+        BYTE deviceTypeModifier; 
+        BYTE removableMedia; 
+        BYTE commandQueueing; 
+        addr vendorIdOffset; 
+        addr productIdOffset;  
+        addr productRevisionOffset; 
+        addr serialNumberOffset; 
+        int busType; 
+        INT rawPropertiesLength;   
+        BYTE rawDeviceProperties[]={length=1};
+      } 
+
+    if (file.deviceIoControl( 0x002d1400/*IOCTL_STORAGE_QUERY_PROPERTY*/,query,descriptor))  {
+     
+        var buffer = ..raw.buffer(descriptor.size); 
+        file.deviceIoControl( 0x002d1400/*IOCTL_STORAGE_QUERY_PROPERTY*/ ,query,buffer);
+        
+        descriptor.rawDeviceProperties.length = descriptor.rawPropertiesLength : 1;
+        ..raw.convert(buffer,descriptor); 
+        
+        var trim = function(n){
+            if( n <= 0 ) return;
+            var s = ..raw.str(buffer,,n);
+            if( s ) return ..string.trim(s);
+        }
+
+    	with(descriptor){
+    	    isUsbDevice = busType == 7/*_BusTypeUsb*/;
+    		devicePath = devicePath;
+        	vendorId = trim(vendorIdOffset);
+        	productRevision = trim(productRevisionOffset);
+        	productId = trim(productIdOffset);
+        	serialNumber = trim(serialNumberOffset); 
+        	if(#serialNumber==8){
+        		var s = {};
+   				for(i=1;8;2) ..table.push(s,serialNumber[i+1],serialNumber[i]); 
+   				serialNumber = ..string.pack(s);
+        	}
+        }
+    }
+    
+    file.close();
+    return descriptor;             
+}
+
+isUsbDevice = function(devicePath){
+	return queryProperty(devicePath)[["isUsbDevice"]];
+}
+
+getDeviceNumber = function(devicePath){
+    if( type(devicePath) != type.string ) error("请指定设备名或盘符",2);
+    
+    if( ..string.startWith(devicePath,"\Device\",true) ) devicePath = ..string.replace(devicePath,"^\\Device\\","\\\\.\\"); 
+    if(! ..string.match(devicePath,"\\\\\p\\") ){
+        devicePath = "\\.\" + devicePath;
+    }
+
+    var file = ..fsys.file(devicePath,0 ); 
+    if (!file) return; 
+ 
+    var deviceNumber = { 
+        int deviceType; 
+        INT deviceNumber;   
+        INT partitionNumber;
+    }
+    var ret = file.deviceIoControl(0x002d1080/*IOCTL_STORAGE_GET_DEVICE_NUMBER*/
+        ,null,deviceNumber)
+    file.close();
+    
+    if( ret ) return deviceNumber;
+}
+
+getDevices = function(flat,usb){
+	var ds = {};
+	for ld in ..fsys.drives.each() {
+		var inf = getDeviceNumber(ld);
+		if(!inf) continue;  
+		if(usb && (!isUsbDevice(inf.deviceNumber) ) ) continue;
+		
+		if(! ds[inf.deviceNumber] ) ds[inf.deviceNumber] = {ld};
+		else ..table.push(ds[inf.deviceNumber] ,ld) ;	
+	}
+	
+	if(flat){
+		var r = {}
+		for(i,d in ds) ..table.append(r,d);
+		..table.sort(r);
+		return r;
+	}
+	return ds;
+}
+
+getUsbDevices = lambda(flat) getDevices(flat,true);
+
+/**intellisense()
+sys.storage = 存储设备属性\n不需要管理权限。\n相关库：fsys.drives, sys.volume
+sys.storage.getUsbDevices( = 返回 U盘 分区
+sys.storage.getUsbDevices(.(true) = 返回 U盘 分区盘符数组
+sys.storage.getUsbDevices(.() = 返回U盘分区列表，\n键为 U盘 设备序号,值为该 U盘 建立的所有分区盘符数组。\n注意设备序号不一定是连续的数值。
+sys.storage.getDevices( = 返回硬盘分区
+sys.storage.getDevices(.(flat,isUsb) = 返回硬盘分区,所有参数都可省略。\n\n如果 @flat 参数为 true 则返回分区盘符数组,\n否则返回硬盘分区列表,键为设备序号,值为该设备创建的分区盘符数组。\n注意设备序号不一定是连续的数值。\n\n@isUsb 如果为 true，则仅返回 USB 设备创建的分区
+sys.storage.queryProperty(.("设备路径) = 可指定设备名、分区盘符、存储设备序号等\n如果不指定参数则自动获取硬盘设备路径
+sys.storage.isUsbDevice(.("设备路径) = 检测是否 U盘,\n参数可指定设备名、分区盘符、存储设备序号等
+sys.storage.queryProperty() = !sysStorageProperty.
+!sysStorageProperty.serialNumber = 序列号
+!sysStorageProperty.productRevision = 产品版本
+!sysStorageProperty.isUsbDevice = 是否 USB 设备
+!sysStorageProperty.productId = 产品ID
+!sysStorageProperty.vendorId = 厂商ID
+!sysStorageProperty.deviceType = 设备类型  
+!sysStorageProperty.deviceTypeModifier = SCSI-2额外的设备类型  
+!sysStorageProperty.removableMedia = 是否可移动  
+!sysStorageProperty.commandQueueing = 是否支持命令队列  
+!sysStorageProperty.busType = 总线类型\n使用 _BusType 前缀常量\n例如U盘是 _BusTypeUsb,其值为7
+sys.storage.getDeviceNumber(.("设备名") = 参数指定分区设备名,或直接指定盘符\n返回存储设备序号
+sys.storage.getDeviceNumber() = !sysStorageDeviceNumber.
+!sysStorageDeviceNumber.deviceType = 类型\n使用 _FILE_DEVICE_ 前缀常量
+!sysStorageDeviceNumber.deviceNumber = 设备序号
+!sysStorageDeviceNumber.partitionNumber = 分区序号
+end intellisense**/
+
+ /**intellisense()
+_BusTypeUnknown=@0/*_BusTypeUnknown*/
+_BusTypeScsi=@1/*_BusTypeScsi*/
+_BusTypeAtapi=@2/*_BusTypeAtapi*/
+_BusTypeAta=@3/*_BusTypeAta*/
+_BusType1394=@4/*_BusType1394*/
+_BusTypeSsa=@5/*_BusTypeSsa*/
+_BusTypeFibre=@6/*_BusTypeFibre*/
+_BusTypeUsb=@7/*_BusTypeUsb*/
+_BusTypeRAID=@8/*_BusTypeRAID*/
+_BusTypeMaxReserved=@0x7F/*_BusTypeMaxReserved*/
+_PropertyStandardQuery=@0/*_PropertyStandardQuery*/
+_PropertyExistsQuery=@1/*_PropertyExistsQuery*/
+_PropertyMaskQuery=@2/*_PropertyMaskQuery*/
+_PropertyQueryMaxDefined=@3/*_PropertyQueryMaxDefined*/
+_StorageDeviceProperty=@0/*_StorageDeviceProperty*/
+_StorageAdapterProperty=@1/*_StorageAdapterProperty*/
+end intellisense**/