github.com/iDigitalFlame/xmt@v0.5.4/cmd/dll_windows.go (about) 1 //go:build windows 2 // +build windows 3 4 // Copyright (C) 2020 - 2023 iDigitalFlame 5 // 6 // This program is free software: you can redistribute it and/or modify 7 // it under the terms of the GNU General Public License as published by 8 // the Free Software Foundation, either version 3 of the License, or 9 // any later version. 10 // 11 // This program is distributed in the hope that it will be useful, 12 // but WITHOUT ANY WARRANTY; without even the implied warranty of 13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 14 // GNU General Public License for more details. 15 // 16 // You should have received a copy of the GNU General Public License 17 // along with this program. If not, see <https://www.gnu.org/licenses/>. 18 // 19 20 package cmd 21 22 import ( 23 "github.com/iDigitalFlame/xmt/cmd/filter" 24 "github.com/iDigitalFlame/xmt/device/winapi" 25 "github.com/iDigitalFlame/xmt/util/xerr" 26 ) 27 28 // Pid returns the process ID of the owning process (the process running 29 // the thread.) 30 // 31 // This may return zero if the thread has not yet been started. 32 func (d *DLL) Pid() uint32 { 33 return d.t.Pid() 34 } 35 36 // Start will attempt to start the DLL and will return an errors that occur while 37 // starting the DLL. 38 // 39 // This function will return 'ErrEmptyCommand' if the 'Path' parameter is empty 40 // and 'ErrAlreadyStarted' if attempting to start a DLL that already has been 41 // started previously. 42 // 43 // Always returns 'ErrNoWindows' on non-Windows devices. 44 func (d *DLL) Start() error { 45 if len(d.Path) == 0 { 46 return ErrEmptyCommand 47 } 48 if d.Running() { 49 return ErrAlreadyStarted 50 } 51 p, err := winapi.UTF16FromString(d.Path) 52 if err != nil { 53 return xerr.Wrap("could not convert path", err) 54 } 55 b := make([]byte, (len(p)*2)+1) 56 for i := 0; i < len(b)-1; i += 2 { 57 b[i], b[i+1] = byte(p[i/2]), byte(p[i/2]>>8) 58 } 59 if err := d.t.Start(0, d.Timeout, winapi.LoadLibraryAddress(), b); err != nil { 60 return err 61 } 62 b = nil 63 go d.t.wait(0, 0) 64 return nil 65 } 66 67 // SetParent will instruct the DLL to choose a parent with the supplied process 68 // Filter. If the Filter is nil this will use the current process (default). 69 // 70 // This function has no effect if the device is not running Windows. 71 func (d *DLL) SetParent(f *filter.Filter) { 72 d.t.filter = f 73 }