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  }