Source file src/cmd/vendor/golang.org/x/sys/windows/setupapi_windows.go

     1  // Copyright 2021 The Go Authors. All rights reserved.
     2  // Use of this source code is governed by a BSD-style
     3  // license that can be found in the LICENSE file.
     4  
     5  package windows
     6  
     7  import (
     8  	"encoding/binary"
     9  	"errors"
    10  	"fmt"
    11  	"runtime"
    12  	"strings"
    13  	"syscall"
    14  	"unsafe"
    15  )
    16  
    17  // This file contains functions that wrap SetupAPI.dll and CfgMgr32.dll,
    18  // core system functions for managing hardware devices, drivers, and the PnP tree.
    19  // Information about these APIs can be found at:
    20  //     https://docs.microsoft.com/en-us/windows-hardware/drivers/install/setupapi
    21  //     https://docs.microsoft.com/en-us/windows/win32/devinst/cfgmgr32-
    22  
    23  const (
    24  	ERROR_EXPECTED_SECTION_NAME                  Errno = 0x20000000 | 0xC0000000 | 0
    25  	ERROR_BAD_SECTION_NAME_LINE                  Errno = 0x20000000 | 0xC0000000 | 1
    26  	ERROR_SECTION_NAME_TOO_LONG                  Errno = 0x20000000 | 0xC0000000 | 2
    27  	ERROR_GENERAL_SYNTAX                         Errno = 0x20000000 | 0xC0000000 | 3
    28  	ERROR_WRONG_INF_STYLE                        Errno = 0x20000000 | 0xC0000000 | 0x100
    29  	ERROR_SECTION_NOT_FOUND                      Errno = 0x20000000 | 0xC0000000 | 0x101
    30  	ERROR_LINE_NOT_FOUND                         Errno = 0x20000000 | 0xC0000000 | 0x102
    31  	ERROR_NO_BACKUP                              Errno = 0x20000000 | 0xC0000000 | 0x103
    32  	ERROR_NO_ASSOCIATED_CLASS                    Errno = 0x20000000 | 0xC0000000 | 0x200
    33  	ERROR_CLASS_MISMATCH                         Errno = 0x20000000 | 0xC0000000 | 0x201
    34  	ERROR_DUPLICATE_FOUND                        Errno = 0x20000000 | 0xC0000000 | 0x202
    35  	ERROR_NO_DRIVER_SELECTED                     Errno = 0x20000000 | 0xC0000000 | 0x203
    36  	ERROR_KEY_DOES_NOT_EXIST                     Errno = 0x20000000 | 0xC0000000 | 0x204
    37  	ERROR_INVALID_DEVINST_NAME                   Errno = 0x20000000 | 0xC0000000 | 0x205
    38  	ERROR_INVALID_CLASS                          Errno = 0x20000000 | 0xC0000000 | 0x206
    39  	ERROR_DEVINST_ALREADY_EXISTS                 Errno = 0x20000000 | 0xC0000000 | 0x207
    40  	ERROR_DEVINFO_NOT_REGISTERED                 Errno = 0x20000000 | 0xC0000000 | 0x208
    41  	ERROR_INVALID_REG_PROPERTY                   Errno = 0x20000000 | 0xC0000000 | 0x209
    42  	ERROR_NO_INF                                 Errno = 0x20000000 | 0xC0000000 | 0x20A
    43  	ERROR_NO_SUCH_DEVINST                        Errno = 0x20000000 | 0xC0000000 | 0x20B
    44  	ERROR_CANT_LOAD_CLASS_ICON                   Errno = 0x20000000 | 0xC0000000 | 0x20C
    45  	ERROR_INVALID_CLASS_INSTALLER                Errno = 0x20000000 | 0xC0000000 | 0x20D
    46  	ERROR_DI_DO_DEFAULT                          Errno = 0x20000000 | 0xC0000000 | 0x20E
    47  	ERROR_DI_NOFILECOPY                          Errno = 0x20000000 | 0xC0000000 | 0x20F
    48  	ERROR_INVALID_HWPROFILE                      Errno = 0x20000000 | 0xC0000000 | 0x210
    49  	ERROR_NO_DEVICE_SELECTED                     Errno = 0x20000000 | 0xC0000000 | 0x211
    50  	ERROR_DEVINFO_LIST_LOCKED                    Errno = 0x20000000 | 0xC0000000 | 0x212
    51  	ERROR_DEVINFO_DATA_LOCKED                    Errno = 0x20000000 | 0xC0000000 | 0x213
    52  	ERROR_DI_BAD_PATH                            Errno = 0x20000000 | 0xC0000000 | 0x214
    53  	ERROR_NO_CLASSINSTALL_PARAMS                 Errno = 0x20000000 | 0xC0000000 | 0x215
    54  	ERROR_FILEQUEUE_LOCKED                       Errno = 0x20000000 | 0xC0000000 | 0x216
    55  	ERROR_BAD_SERVICE_INSTALLSECT                Errno = 0x20000000 | 0xC0000000 | 0x217
    56  	ERROR_NO_CLASS_DRIVER_LIST                   Errno = 0x20000000 | 0xC0000000 | 0x218
    57  	ERROR_NO_ASSOCIATED_SERVICE                  Errno = 0x20000000 | 0xC0000000 | 0x219
    58  	ERROR_NO_DEFAULT_DEVICE_INTERFACE            Errno = 0x20000000 | 0xC0000000 | 0x21A
    59  	ERROR_DEVICE_INTERFACE_ACTIVE                Errno = 0x20000000 | 0xC0000000 | 0x21B
    60  	ERROR_DEVICE_INTERFACE_REMOVED               Errno = 0x20000000 | 0xC0000000 | 0x21C
    61  	ERROR_BAD_INTERFACE_INSTALLSECT              Errno = 0x20000000 | 0xC0000000 | 0x21D
    62  	ERROR_NO_SUCH_INTERFACE_CLASS                Errno = 0x20000000 | 0xC0000000 | 0x21E
    63  	ERROR_INVALID_REFERENCE_STRING               Errno = 0x20000000 | 0xC0000000 | 0x21F
    64  	ERROR_INVALID_MACHINENAME                    Errno = 0x20000000 | 0xC0000000 | 0x220
    65  	ERROR_REMOTE_COMM_FAILURE                    Errno = 0x20000000 | 0xC0000000 | 0x221
    66  	ERROR_MACHINE_UNAVAILABLE                    Errno = 0x20000000 | 0xC0000000 | 0x222
    67  	ERROR_NO_CONFIGMGR_SERVICES                  Errno = 0x20000000 | 0xC0000000 | 0x223
    68  	ERROR_INVALID_PROPPAGE_PROVIDER              Errno = 0x20000000 | 0xC0000000 | 0x224
    69  	ERROR_NO_SUCH_DEVICE_INTERFACE               Errno = 0x20000000 | 0xC0000000 | 0x225
    70  	ERROR_DI_POSTPROCESSING_REQUIRED             Errno = 0x20000000 | 0xC0000000 | 0x226
    71  	ERROR_INVALID_COINSTALLER                    Errno = 0x20000000 | 0xC0000000 | 0x227
    72  	ERROR_NO_COMPAT_DRIVERS                      Errno = 0x20000000 | 0xC0000000 | 0x228
    73  	ERROR_NO_DEVICE_ICON                         Errno = 0x20000000 | 0xC0000000 | 0x229
    74  	ERROR_INVALID_INF_LOGCONFIG                  Errno = 0x20000000 | 0xC0000000 | 0x22A
    75  	ERROR_DI_DONT_INSTALL                        Errno = 0x20000000 | 0xC0000000 | 0x22B
    76  	ERROR_INVALID_FILTER_DRIVER                  Errno = 0x20000000 | 0xC0000000 | 0x22C
    77  	ERROR_NON_WINDOWS_NT_DRIVER                  Errno = 0x20000000 | 0xC0000000 | 0x22D
    78  	ERROR_NON_WINDOWS_DRIVER                     Errno = 0x20000000 | 0xC0000000 | 0x22E
    79  	ERROR_NO_CATALOG_FOR_OEM_INF                 Errno = 0x20000000 | 0xC0000000 | 0x22F
    80  	ERROR_DEVINSTALL_QUEUE_NONNATIVE             Errno = 0x20000000 | 0xC0000000 | 0x230
    81  	ERROR_NOT_DISABLEABLE                        Errno = 0x20000000 | 0xC0000000 | 0x231
    82  	ERROR_CANT_REMOVE_DEVINST                    Errno = 0x20000000 | 0xC0000000 | 0x232
    83  	ERROR_INVALID_TARGET                         Errno = 0x20000000 | 0xC0000000 | 0x233
    84  	ERROR_DRIVER_NONNATIVE                       Errno = 0x20000000 | 0xC0000000 | 0x234
    85  	ERROR_IN_WOW64                               Errno = 0x20000000 | 0xC0000000 | 0x235
    86  	ERROR_SET_SYSTEM_RESTORE_POINT               Errno = 0x20000000 | 0xC0000000 | 0x236
    87  	ERROR_SCE_DISABLED                           Errno = 0x20000000 | 0xC0000000 | 0x238
    88  	ERROR_UNKNOWN_EXCEPTION                      Errno = 0x20000000 | 0xC0000000 | 0x239
    89  	ERROR_PNP_REGISTRY_ERROR                     Errno = 0x20000000 | 0xC0000000 | 0x23A
    90  	ERROR_REMOTE_REQUEST_UNSUPPORTED             Errno = 0x20000000 | 0xC0000000 | 0x23B
    91  	ERROR_NOT_AN_INSTALLED_OEM_INF               Errno = 0x20000000 | 0xC0000000 | 0x23C
    92  	ERROR_INF_IN_USE_BY_DEVICES                  Errno = 0x20000000 | 0xC0000000 | 0x23D
    93  	ERROR_DI_FUNCTION_OBSOLETE                   Errno = 0x20000000 | 0xC0000000 | 0x23E
    94  	ERROR_NO_AUTHENTICODE_CATALOG                Errno = 0x20000000 | 0xC0000000 | 0x23F
    95  	ERROR_AUTHENTICODE_DISALLOWED                Errno = 0x20000000 | 0xC0000000 | 0x240
    96  	ERROR_AUTHENTICODE_TRUSTED_PUBLISHER         Errno = 0x20000000 | 0xC0000000 | 0x241
    97  	ERROR_AUTHENTICODE_TRUST_NOT_ESTABLISHED     Errno = 0x20000000 | 0xC0000000 | 0x242
    98  	ERROR_AUTHENTICODE_PUBLISHER_NOT_TRUSTED     Errno = 0x20000000 | 0xC0000000 | 0x243
    99  	ERROR_SIGNATURE_OSATTRIBUTE_MISMATCH         Errno = 0x20000000 | 0xC0000000 | 0x244
   100  	ERROR_ONLY_VALIDATE_VIA_AUTHENTICODE         Errno = 0x20000000 | 0xC0000000 | 0x245
   101  	ERROR_DEVICE_INSTALLER_NOT_READY             Errno = 0x20000000 | 0xC0000000 | 0x246
   102  	ERROR_DRIVER_STORE_ADD_FAILED                Errno = 0x20000000 | 0xC0000000 | 0x247
   103  	ERROR_DEVICE_INSTALL_BLOCKED                 Errno = 0x20000000 | 0xC0000000 | 0x248
   104  	ERROR_DRIVER_INSTALL_BLOCKED                 Errno = 0x20000000 | 0xC0000000 | 0x249
   105  	ERROR_WRONG_INF_TYPE                         Errno = 0x20000000 | 0xC0000000 | 0x24A
   106  	ERROR_FILE_HASH_NOT_IN_CATALOG               Errno = 0x20000000 | 0xC0000000 | 0x24B
   107  	ERROR_DRIVER_STORE_DELETE_FAILED             Errno = 0x20000000 | 0xC0000000 | 0x24C
   108  	ERROR_UNRECOVERABLE_STACK_OVERFLOW           Errno = 0x20000000 | 0xC0000000 | 0x300
   109  	EXCEPTION_SPAPI_UNRECOVERABLE_STACK_OVERFLOW Errno = ERROR_UNRECOVERABLE_STACK_OVERFLOW
   110  	ERROR_NO_DEFAULT_INTERFACE_DEVICE            Errno = ERROR_NO_DEFAULT_DEVICE_INTERFACE
   111  	ERROR_INTERFACE_DEVICE_ACTIVE                Errno = ERROR_DEVICE_INTERFACE_ACTIVE
   112  	ERROR_INTERFACE_DEVICE_REMOVED               Errno = ERROR_DEVICE_INTERFACE_REMOVED
   113  	ERROR_NO_SUCH_INTERFACE_DEVICE               Errno = ERROR_NO_SUCH_DEVICE_INTERFACE
   114  )
   115  
   116  const (
   117  	MAX_DEVICE_ID_LEN   = 200
   118  	MAX_DEVNODE_ID_LEN  = MAX_DEVICE_ID_LEN
   119  	MAX_GUID_STRING_LEN = 39 // 38 chars + terminator null
   120  	MAX_CLASS_NAME_LEN  = 32
   121  	MAX_PROFILE_LEN     = 80
   122  	MAX_CONFIG_VALUE    = 9999
   123  	MAX_INSTANCE_VALUE  = 9999
   124  	CONFIGMG_VERSION    = 0x0400
   125  )
   126  
   127  // Maximum string length constants
   128  const (
   129  	LINE_LEN                    = 256  // Windows 9x-compatible maximum for displayable strings coming from a device INF.
   130  	MAX_INF_STRING_LENGTH       = 4096 // Actual maximum size of an INF string (including string substitutions).
   131  	MAX_INF_SECTION_NAME_LENGTH = 255  // For Windows 9x compatibility, INF section names should be constrained to 32 characters.
   132  	MAX_TITLE_LEN               = 60
   133  	MAX_INSTRUCTION_LEN         = 256
   134  	MAX_LABEL_LEN               = 30
   135  	MAX_SERVICE_NAME_LEN        = 256
   136  	MAX_SUBTITLE_LEN            = 256
   137  )
   138  
   139  const (
   140  	// SP_MAX_MACHINENAME_LENGTH defines maximum length of a machine name in the format expected by ConfigMgr32 CM_Connect_Machine (i.e., "\\\\MachineName\0").
   141  	SP_MAX_MACHINENAME_LENGTH = MAX_PATH + 3
   142  )
   143  
   144  // HSPFILEQ is type for setup file queue
   145  type HSPFILEQ uintptr
   146  
   147  // DevInfo holds reference to device information set
   148  type DevInfo Handle
   149  
   150  // DEVINST is a handle usually recognized by cfgmgr32 APIs
   151  type DEVINST uint32
   152  
   153  // DevInfoData is a device information structure (references a device instance that is a member of a device information set)
   154  type DevInfoData struct {
   155  	size      uint32
   156  	ClassGUID GUID
   157  	DevInst   DEVINST
   158  	_         uintptr
   159  }
   160  
   161  // DevInfoListDetailData is a structure for detailed information on a device information set (used for SetupDiGetDeviceInfoListDetail which supersedes the functionality of SetupDiGetDeviceInfoListClass).
   162  type DevInfoListDetailData struct {
   163  	size                uint32 // Use unsafeSizeOf method
   164  	ClassGUID           GUID
   165  	RemoteMachineHandle Handle
   166  	remoteMachineName   [SP_MAX_MACHINENAME_LENGTH]uint16
   167  }
   168  
   169  func (*DevInfoListDetailData) unsafeSizeOf() uint32 {
   170  	if unsafe.Sizeof(uintptr(0)) == 4 {
   171  		// Windows declares this with pshpack1.h
   172  		return uint32(unsafe.Offsetof(DevInfoListDetailData{}.remoteMachineName) + unsafe.Sizeof(DevInfoListDetailData{}.remoteMachineName))
   173  	}
   174  	return uint32(unsafe.Sizeof(DevInfoListDetailData{}))
   175  }
   176  
   177  func (data *DevInfoListDetailData) RemoteMachineName() string {
   178  	return UTF16ToString(data.remoteMachineName[:])
   179  }
   180  
   181  func (data *DevInfoListDetailData) SetRemoteMachineName(remoteMachineName string) error {
   182  	str, err := UTF16FromString(remoteMachineName)
   183  	if err != nil {
   184  		return err
   185  	}
   186  	copy(data.remoteMachineName[:], str)
   187  	return nil
   188  }
   189  
   190  // DI_FUNCTION is function type for device installer
   191  type DI_FUNCTION uint32
   192  
   193  const (
   194  	DIF_SELECTDEVICE                   DI_FUNCTION = 0x00000001
   195  	DIF_INSTALLDEVICE                  DI_FUNCTION = 0x00000002
   196  	DIF_ASSIGNRESOURCES                DI_FUNCTION = 0x00000003
   197  	DIF_PROPERTIES                     DI_FUNCTION = 0x00000004
   198  	DIF_REMOVE                         DI_FUNCTION = 0x00000005
   199  	DIF_FIRSTTIMESETUP                 DI_FUNCTION = 0x00000006
   200  	DIF_FOUNDDEVICE                    DI_FUNCTION = 0x00000007
   201  	DIF_SELECTCLASSDRIVERS             DI_FUNCTION = 0x00000008
   202  	DIF_VALIDATECLASSDRIVERS           DI_FUNCTION = 0x00000009
   203  	DIF_INSTALLCLASSDRIVERS            DI_FUNCTION = 0x0000000A
   204  	DIF_CALCDISKSPACE                  DI_FUNCTION = 0x0000000B
   205  	DIF_DESTROYPRIVATEDATA             DI_FUNCTION = 0x0000000C
   206  	DIF_VALIDATEDRIVER                 DI_FUNCTION = 0x0000000D
   207  	DIF_DETECT                         DI_FUNCTION = 0x0000000F
   208  	DIF_INSTALLWIZARD                  DI_FUNCTION = 0x00000010
   209  	DIF_DESTROYWIZARDDATA              DI_FUNCTION = 0x00000011
   210  	DIF_PROPERTYCHANGE                 DI_FUNCTION = 0x00000012
   211  	DIF_ENABLECLASS                    DI_FUNCTION = 0x00000013
   212  	DIF_DETECTVERIFY                   DI_FUNCTION = 0x00000014
   213  	DIF_INSTALLDEVICEFILES             DI_FUNCTION = 0x00000015
   214  	DIF_UNREMOVE                       DI_FUNCTION = 0x00000016
   215  	DIF_SELECTBESTCOMPATDRV            DI_FUNCTION = 0x00000017
   216  	DIF_ALLOW_INSTALL                  DI_FUNCTION = 0x00000018
   217  	DIF_REGISTERDEVICE                 DI_FUNCTION = 0x00000019
   218  	DIF_NEWDEVICEWIZARD_PRESELECT      DI_FUNCTION = 0x0000001A
   219  	DIF_NEWDEVICEWIZARD_SELECT         DI_FUNCTION = 0x0000001B
   220  	DIF_NEWDEVICEWIZARD_PREANALYZE     DI_FUNCTION = 0x0000001C
   221  	DIF_NEWDEVICEWIZARD_POSTANALYZE    DI_FUNCTION = 0x0000001D
   222  	DIF_NEWDEVICEWIZARD_FINISHINSTALL  DI_FUNCTION = 0x0000001E
   223  	DIF_INSTALLINTERFACES              DI_FUNCTION = 0x00000020
   224  	DIF_DETECTCANCEL                   DI_FUNCTION = 0x00000021
   225  	DIF_REGISTER_COINSTALLERS          DI_FUNCTION = 0x00000022
   226  	DIF_ADDPROPERTYPAGE_ADVANCED       DI_FUNCTION = 0x00000023
   227  	DIF_ADDPROPERTYPAGE_BASIC          DI_FUNCTION = 0x00000024
   228  	DIF_TROUBLESHOOTER                 DI_FUNCTION = 0x00000026
   229  	DIF_POWERMESSAGEWAKE               DI_FUNCTION = 0x00000027
   230  	DIF_ADDREMOTEPROPERTYPAGE_ADVANCED DI_FUNCTION = 0x00000028
   231  	DIF_UPDATEDRIVER_UI                DI_FUNCTION = 0x00000029
   232  	DIF_FINISHINSTALL_ACTION           DI_FUNCTION = 0x0000002A
   233  )
   234  
   235  // DevInstallParams is device installation parameters structure (associated with a particular device information element, or globally with a device information set)
   236  type DevInstallParams struct {
   237  	size                     uint32
   238  	Flags                    DI_FLAGS
   239  	FlagsEx                  DI_FLAGSEX
   240  	hwndParent               uintptr
   241  	InstallMsgHandler        uintptr
   242  	InstallMsgHandlerContext uintptr
   243  	FileQueue                HSPFILEQ
   244  	_                        uintptr
   245  	_                        uint32
   246  	driverPath               [MAX_PATH]uint16
   247  }
   248  
   249  func (params *DevInstallParams) DriverPath() string {
   250  	return UTF16ToString(params.driverPath[:])
   251  }
   252  
   253  func (params *DevInstallParams) SetDriverPath(driverPath string) error {
   254  	str, err := UTF16FromString(driverPath)
   255  	if err != nil {
   256  		return err
   257  	}
   258  	copy(params.driverPath[:], str)
   259  	return nil
   260  }
   261  
   262  // DI_FLAGS is SP_DEVINSTALL_PARAMS.Flags values
   263  type DI_FLAGS uint32
   264  
   265  const (
   266  	// Flags for choosing a device
   267  	DI_SHOWOEM       DI_FLAGS = 0x00000001 // support Other... button
   268  	DI_SHOWCOMPAT    DI_FLAGS = 0x00000002 // show compatibility list
   269  	DI_SHOWCLASS     DI_FLAGS = 0x00000004 // show class list
   270  	DI_SHOWALL       DI_FLAGS = 0x00000007 // both class & compat list shown
   271  	DI_NOVCP         DI_FLAGS = 0x00000008 // don't create a new copy queue--use caller-supplied FileQueue
   272  	DI_DIDCOMPAT     DI_FLAGS = 0x00000010 // Searched for compatible devices
   273  	DI_DIDCLASS      DI_FLAGS = 0x00000020 // Searched for class devices
   274  	DI_AUTOASSIGNRES DI_FLAGS = 0x00000040 // No UI for resources if possible
   275  
   276  	// Flags returned by DiInstallDevice to indicate need to reboot/restart
   277  	DI_NEEDRESTART DI_FLAGS = 0x00000080 // Reboot required to take effect
   278  	DI_NEEDREBOOT  DI_FLAGS = 0x00000100 // ""
   279  
   280  	// Flags for device installation
   281  	DI_NOBROWSE DI_FLAGS = 0x00000200 // no Browse... in InsertDisk
   282  
   283  	// Flags set by DiBuildDriverInfoList
   284  	DI_MULTMFGS DI_FLAGS = 0x00000400 // Set if multiple manufacturers in class driver list
   285  
   286  	// Flag indicates that device is disabled
   287  	DI_DISABLED DI_FLAGS = 0x00000800 // Set if device disabled
   288  
   289  	// Flags for Device/Class Properties
   290  	DI_GENERALPAGE_ADDED  DI_FLAGS = 0x00001000
   291  	DI_RESOURCEPAGE_ADDED DI_FLAGS = 0x00002000
   292  
   293  	// Flag to indicate the setting properties for this Device (or class) caused a change so the Dev Mgr UI probably needs to be updated.
   294  	DI_PROPERTIES_CHANGE DI_FLAGS = 0x00004000
   295  
   296  	// Flag to indicate that the sorting from the INF file should be used.
   297  	DI_INF_IS_SORTED DI_FLAGS = 0x00008000
   298  
   299  	// Flag to indicate that only the the INF specified by SP_DEVINSTALL_PARAMS.DriverPath should be searched.
   300  	DI_ENUMSINGLEINF DI_FLAGS = 0x00010000
   301  
   302  	// Flag that prevents ConfigMgr from removing/re-enumerating devices during device
   303  	// registration, installation, and deletion.
   304  	DI_DONOTCALLCONFIGMG DI_FLAGS = 0x00020000
   305  
   306  	// The following flag can be used to install a device disabled
   307  	DI_INSTALLDISABLED DI_FLAGS = 0x00040000
   308  
   309  	// Flag that causes SetupDiBuildDriverInfoList to build a device's compatible driver
   310  	// list from its existing class driver list, instead of the normal INF search.
   311  	DI_COMPAT_FROM_CLASS DI_FLAGS = 0x00080000
   312  
   313  	// This flag is set if the Class Install params should be used.
   314  	DI_CLASSINSTALLPARAMS DI_FLAGS = 0x00100000
   315  
   316  	// This flag is set if the caller of DiCallClassInstaller does NOT want the internal default action performed if the Class installer returns ERROR_DI_DO_DEFAULT.
   317  	DI_NODI_DEFAULTACTION DI_FLAGS = 0x00200000
   318  
   319  	// Flags for device installation
   320  	DI_QUIETINSTALL        DI_FLAGS = 0x00800000 // don't confuse the user with questions or excess info
   321  	DI_NOFILECOPY          DI_FLAGS = 0x01000000 // No file Copy necessary
   322  	DI_FORCECOPY           DI_FLAGS = 0x02000000 // Force files to be copied from install path
   323  	DI_DRIVERPAGE_ADDED    DI_FLAGS = 0x04000000 // Prop provider added Driver page.
   324  	DI_USECI_SELECTSTRINGS DI_FLAGS = 0x08000000 // Use Class Installer Provided strings in the Select Device Dlg
   325  	DI_OVERRIDE_INFFLAGS   DI_FLAGS = 0x10000000 // Override INF flags
   326  	DI_PROPS_NOCHANGEUSAGE DI_FLAGS = 0x20000000 // No Enable/Disable in General Props
   327  
   328  	DI_NOSELECTICONS DI_FLAGS = 0x40000000 // No small icons in select device dialogs
   329  
   330  	DI_NOWRITE_IDS DI_FLAGS = 0x80000000 // Don't write HW & Compat IDs on install
   331  )
   332  
   333  // DI_FLAGSEX is SP_DEVINSTALL_PARAMS.FlagsEx values
   334  type DI_FLAGSEX uint32
   335  
   336  const (
   337  	DI_FLAGSEX_CI_FAILED                DI_FLAGSEX = 0x00000004 // Failed to Load/Call class installer
   338  	DI_FLAGSEX_FINISHINSTALL_ACTION     DI_FLAGSEX = 0x00000008 // Class/co-installer wants to get a DIF_FINISH_INSTALL action in client context.
   339  	DI_FLAGSEX_DIDINFOLIST              DI_FLAGSEX = 0x00000010 // Did the Class Info List
   340  	DI_FLAGSEX_DIDCOMPATINFO            DI_FLAGSEX = 0x00000020 // Did the Compat Info List
   341  	DI_FLAGSEX_FILTERCLASSES            DI_FLAGSEX = 0x00000040
   342  	DI_FLAGSEX_SETFAILEDINSTALL         DI_FLAGSEX = 0x00000080
   343  	DI_FLAGSEX_DEVICECHANGE             DI_FLAGSEX = 0x00000100
   344  	DI_FLAGSEX_ALWAYSWRITEIDS           DI_FLAGSEX = 0x00000200
   345  	DI_FLAGSEX_PROPCHANGE_PENDING       DI_FLAGSEX = 0x00000400 // One or more device property sheets have had changes made to them, and need to have a DIF_PROPERTYCHANGE occur.
   346  	DI_FLAGSEX_ALLOWEXCLUDEDDRVS        DI_FLAGSEX = 0x00000800
   347  	DI_FLAGSEX_NOUIONQUERYREMOVE        DI_FLAGSEX = 0x00001000
   348  	DI_FLAGSEX_USECLASSFORCOMPAT        DI_FLAGSEX = 0x00002000 // Use the device's class when building compat drv list. (Ignored if DI_COMPAT_FROM_CLASS flag is specified.)
   349  	DI_FLAGSEX_NO_DRVREG_MODIFY         DI_FLAGSEX = 0x00008000 // Don't run AddReg and DelReg for device's software (driver) key.
   350  	DI_FLAGSEX_IN_SYSTEM_SETUP          DI_FLAGSEX = 0x00010000 // Installation is occurring during initial system setup.
   351  	DI_FLAGSEX_INET_DRIVER              DI_FLAGSEX = 0x00020000 // Driver came from Windows Update
   352  	DI_FLAGSEX_APPENDDRIVERLIST         DI_FLAGSEX = 0x00040000 // Cause SetupDiBuildDriverInfoList to append a new driver list to an existing list.
   353  	DI_FLAGSEX_PREINSTALLBACKUP         DI_FLAGSEX = 0x00080000 // not used
   354  	DI_FLAGSEX_BACKUPONREPLACE          DI_FLAGSEX = 0x00100000 // not used
   355  	DI_FLAGSEX_DRIVERLIST_FROM_URL      DI_FLAGSEX = 0x00200000 // build driver list from INF(s) retrieved from URL specified in SP_DEVINSTALL_PARAMS.DriverPath (empty string means Windows Update website)
   356  	DI_FLAGSEX_EXCLUDE_OLD_INET_DRIVERS DI_FLAGSEX = 0x00800000 // Don't include old Internet drivers when building a driver list. Ignored on Windows Vista and later.
   357  	DI_FLAGSEX_POWERPAGE_ADDED          DI_FLAGSEX = 0x01000000 // class installer added their own power page
   358  	DI_FLAGSEX_FILTERSIMILARDRIVERS     DI_FLAGSEX = 0x02000000 // only include similar drivers in class list
   359  	DI_FLAGSEX_INSTALLEDDRIVER          DI_FLAGSEX = 0x04000000 // only add the installed driver to the class or compat driver list.  Used in calls to SetupDiBuildDriverInfoList
   360  	DI_FLAGSEX_NO_CLASSLIST_NODE_MERGE  DI_FLAGSEX = 0x08000000 // Don't remove identical driver nodes from the class list
   361  	DI_FLAGSEX_ALTPLATFORM_DRVSEARCH    DI_FLAGSEX = 0x10000000 // Build driver list based on alternate platform information specified in associated file queue
   362  	DI_FLAGSEX_RESTART_DEVICE_ONLY      DI_FLAGSEX = 0x20000000 // only restart the device drivers are being installed on as opposed to restarting all devices using those drivers.
   363  	DI_FLAGSEX_RECURSIVESEARCH          DI_FLAGSEX = 0x40000000 // Tell SetupDiBuildDriverInfoList to do a recursive search
   364  	DI_FLAGSEX_SEARCH_PUBLISHED_INFS    DI_FLAGSEX = 0x80000000 // Tell SetupDiBuildDriverInfoList to do a "published INF" search
   365  )
   366  
   367  // ClassInstallHeader is the first member of any class install parameters structure. It contains the device installation request code that defines the format of the rest of the install parameters structure.
   368  type ClassInstallHeader struct {
   369  	size            uint32
   370  	InstallFunction DI_FUNCTION
   371  }
   372  
   373  func MakeClassInstallHeader(installFunction DI_FUNCTION) *ClassInstallHeader {
   374  	hdr := &ClassInstallHeader{InstallFunction: installFunction}
   375  	hdr.size = uint32(unsafe.Sizeof(*hdr))
   376  	return hdr
   377  }
   378  
   379  // DICS_STATE specifies values indicating a change in a device's state
   380  type DICS_STATE uint32
   381  
   382  const (
   383  	DICS_ENABLE     DICS_STATE = 0x00000001 // The device is being enabled.
   384  	DICS_DISABLE    DICS_STATE = 0x00000002 // The device is being disabled.
   385  	DICS_PROPCHANGE DICS_STATE = 0x00000003 // The properties of the device have changed.
   386  	DICS_START      DICS_STATE = 0x00000004 // The device is being started (if the request is for the currently active hardware profile).
   387  	DICS_STOP       DICS_STATE = 0x00000005 // The device is being stopped. The driver stack will be unloaded and the CSCONFIGFLAG_DO_NOT_START flag will be set for the device.
   388  )
   389  
   390  // DICS_FLAG specifies the scope of a device property change
   391  type DICS_FLAG uint32
   392  
   393  const (
   394  	DICS_FLAG_GLOBAL         DICS_FLAG = 0x00000001 // make change in all hardware profiles
   395  	DICS_FLAG_CONFIGSPECIFIC DICS_FLAG = 0x00000002 // make change in specified profile only
   396  	DICS_FLAG_CONFIGGENERAL  DICS_FLAG = 0x00000004 // 1 or more hardware profile-specific changes to follow (obsolete)
   397  )
   398  
   399  // PropChangeParams is a structure corresponding to a DIF_PROPERTYCHANGE install function.
   400  type PropChangeParams struct {
   401  	ClassInstallHeader ClassInstallHeader
   402  	StateChange        DICS_STATE
   403  	Scope              DICS_FLAG
   404  	HwProfile          uint32
   405  }
   406  
   407  // DI_REMOVEDEVICE specifies the scope of the device removal
   408  type DI_REMOVEDEVICE uint32
   409  
   410  const (
   411  	DI_REMOVEDEVICE_GLOBAL         DI_REMOVEDEVICE = 0x00000001 // Make this change in all hardware profiles. Remove information about the device from the registry.
   412  	DI_REMOVEDEVICE_CONFIGSPECIFIC DI_REMOVEDEVICE = 0x00000002 // Make this change to only the hardware profile specified by HwProfile. this flag only applies to root-enumerated devices. When Windows removes the device from the last hardware profile in which it was configured, Windows performs a global removal.
   413  )
   414  
   415  // RemoveDeviceParams is a structure corresponding to a DIF_REMOVE install function.
   416  type RemoveDeviceParams struct {
   417  	ClassInstallHeader ClassInstallHeader
   418  	Scope              DI_REMOVEDEVICE
   419  	HwProfile          uint32
   420  }
   421  
   422  // DrvInfoData is driver information structure (member of a driver info list that may be associated with a particular device instance, or (globally) with a device information set)
   423  type DrvInfoData struct {
   424  	size          uint32
   425  	DriverType    uint32
   426  	_             uintptr
   427  	description   [LINE_LEN]uint16
   428  	mfgName       [LINE_LEN]uint16
   429  	providerName  [LINE_LEN]uint16
   430  	DriverDate    Filetime
   431  	DriverVersion uint64
   432  }
   433  
   434  func (data *DrvInfoData) Description() string {
   435  	return UTF16ToString(data.description[:])
   436  }
   437  
   438  func (data *DrvInfoData) SetDescription(description string) error {
   439  	str, err := UTF16FromString(description)
   440  	if err != nil {
   441  		return err
   442  	}
   443  	copy(data.description[:], str)
   444  	return nil
   445  }
   446  
   447  func (data *DrvInfoData) MfgName() string {
   448  	return UTF16ToString(data.mfgName[:])
   449  }
   450  
   451  func (data *DrvInfoData) SetMfgName(mfgName string) error {
   452  	str, err := UTF16FromString(mfgName)
   453  	if err != nil {
   454  		return err
   455  	}
   456  	copy(data.mfgName[:], str)
   457  	return nil
   458  }
   459  
   460  func (data *DrvInfoData) ProviderName() string {
   461  	return UTF16ToString(data.providerName[:])
   462  }
   463  
   464  func (data *DrvInfoData) SetProviderName(providerName string) error {
   465  	str, err := UTF16FromString(providerName)
   466  	if err != nil {
   467  		return err
   468  	}
   469  	copy(data.providerName[:], str)
   470  	return nil
   471  }
   472  
   473  // IsNewer method returns true if DrvInfoData date and version is newer than supplied parameters.
   474  func (data *DrvInfoData) IsNewer(driverDate Filetime, driverVersion uint64) bool {
   475  	if data.DriverDate.HighDateTime > driverDate.HighDateTime {
   476  		return true
   477  	}
   478  	if data.DriverDate.HighDateTime < driverDate.HighDateTime {
   479  		return false
   480  	}
   481  
   482  	if data.DriverDate.LowDateTime > driverDate.LowDateTime {
   483  		return true
   484  	}
   485  	if data.DriverDate.LowDateTime < driverDate.LowDateTime {
   486  		return false
   487  	}
   488  
   489  	if data.DriverVersion > driverVersion {
   490  		return true
   491  	}
   492  	if data.DriverVersion < driverVersion {
   493  		return false
   494  	}
   495  
   496  	return false
   497  }
   498  
   499  // DrvInfoDetailData is driver information details structure (provides detailed information about a particular driver information structure)
   500  type DrvInfoDetailData struct {
   501  	size            uint32 // Use unsafeSizeOf method
   502  	InfDate         Filetime
   503  	compatIDsOffset uint32
   504  	compatIDsLength uint32
   505  	_               uintptr
   506  	sectionName     [LINE_LEN]uint16
   507  	infFileName     [MAX_PATH]uint16
   508  	drvDescription  [LINE_LEN]uint16
   509  	hardwareID      [1]uint16
   510  }
   511  
   512  func (*DrvInfoDetailData) unsafeSizeOf() uint32 {
   513  	if unsafe.Sizeof(uintptr(0)) == 4 {
   514  		// Windows declares this with pshpack1.h
   515  		return uint32(unsafe.Offsetof(DrvInfoDetailData{}.hardwareID) + unsafe.Sizeof(DrvInfoDetailData{}.hardwareID))
   516  	}
   517  	return uint32(unsafe.Sizeof(DrvInfoDetailData{}))
   518  }
   519  
   520  func (data *DrvInfoDetailData) SectionName() string {
   521  	return UTF16ToString(data.sectionName[:])
   522  }
   523  
   524  func (data *DrvInfoDetailData) InfFileName() string {
   525  	return UTF16ToString(data.infFileName[:])
   526  }
   527  
   528  func (data *DrvInfoDetailData) DrvDescription() string {
   529  	return UTF16ToString(data.drvDescription[:])
   530  }
   531  
   532  func (data *DrvInfoDetailData) HardwareID() string {
   533  	if data.compatIDsOffset > 1 {
   534  		bufW := data.getBuf()
   535  		return UTF16ToString(bufW[:wcslen(bufW)])
   536  	}
   537  
   538  	return ""
   539  }
   540  
   541  func (data *DrvInfoDetailData) CompatIDs() []string {
   542  	a := make([]string, 0)
   543  
   544  	if data.compatIDsLength > 0 {
   545  		bufW := data.getBuf()
   546  		bufW = bufW[data.compatIDsOffset : data.compatIDsOffset+data.compatIDsLength]
   547  		for i := 0; i < len(bufW); {
   548  			j := i + wcslen(bufW[i:])
   549  			if i < j {
   550  				a = append(a, UTF16ToString(bufW[i:j]))
   551  			}
   552  			i = j + 1
   553  		}
   554  	}
   555  
   556  	return a
   557  }
   558  
   559  func (data *DrvInfoDetailData) getBuf() []uint16 {
   560  	len := (data.size - uint32(unsafe.Offsetof(data.hardwareID))) / 2
   561  	sl := struct {
   562  		addr *uint16
   563  		len  int
   564  		cap  int
   565  	}{&data.hardwareID[0], int(len), int(len)}
   566  	return *(*[]uint16)(unsafe.Pointer(&sl))
   567  }
   568  
   569  // IsCompatible method tests if given hardware ID matches the driver or is listed on the compatible ID list.
   570  func (data *DrvInfoDetailData) IsCompatible(hwid string) bool {
   571  	hwidLC := strings.ToLower(hwid)
   572  	if strings.ToLower(data.HardwareID()) == hwidLC {
   573  		return true
   574  	}
   575  	a := data.CompatIDs()
   576  	for i := range a {
   577  		if strings.ToLower(a[i]) == hwidLC {
   578  			return true
   579  		}
   580  	}
   581  
   582  	return false
   583  }
   584  
   585  // DICD flags control SetupDiCreateDeviceInfo
   586  type DICD uint32
   587  
   588  const (
   589  	DICD_GENERATE_ID       DICD = 0x00000001
   590  	DICD_INHERIT_CLASSDRVS DICD = 0x00000002
   591  )
   592  
   593  // SUOI flags control SetupUninstallOEMInf
   594  type SUOI uint32
   595  
   596  const (
   597  	SUOI_FORCEDELETE SUOI = 0x0001
   598  )
   599  
   600  // SPDIT flags to distinguish between class drivers and
   601  // device drivers. (Passed in 'DriverType' parameter of
   602  // driver information list APIs)
   603  type SPDIT uint32
   604  
   605  const (
   606  	SPDIT_NODRIVER     SPDIT = 0x00000000
   607  	SPDIT_CLASSDRIVER  SPDIT = 0x00000001
   608  	SPDIT_COMPATDRIVER SPDIT = 0x00000002
   609  )
   610  
   611  // DIGCF flags control what is included in the device information set built by SetupDiGetClassDevs
   612  type DIGCF uint32
   613  
   614  const (
   615  	DIGCF_DEFAULT         DIGCF = 0x00000001 // only valid with DIGCF_DEVICEINTERFACE
   616  	DIGCF_PRESENT         DIGCF = 0x00000002
   617  	DIGCF_ALLCLASSES      DIGCF = 0x00000004
   618  	DIGCF_PROFILE         DIGCF = 0x00000008
   619  	DIGCF_DEVICEINTERFACE DIGCF = 0x00000010
   620  )
   621  
   622  // DIREG specifies values for SetupDiCreateDevRegKey, SetupDiOpenDevRegKey, and SetupDiDeleteDevRegKey.
   623  type DIREG uint32
   624  
   625  const (
   626  	DIREG_DEV  DIREG = 0x00000001 // Open/Create/Delete device key
   627  	DIREG_DRV  DIREG = 0x00000002 // Open/Create/Delete driver key
   628  	DIREG_BOTH DIREG = 0x00000004 // Delete both driver and Device key
   629  )
   630  
   631  // SPDRP specifies device registry property codes
   632  // (Codes marked as read-only (R) may only be used for
   633  // SetupDiGetDeviceRegistryProperty)
   634  //
   635  // These values should cover the same set of registry properties
   636  // as defined by the CM_DRP codes in cfgmgr32.h.
   637  //
   638  // Note that SPDRP codes are zero based while CM_DRP codes are one based!
   639  type SPDRP uint32
   640  
   641  const (
   642  	SPDRP_DEVICEDESC                  SPDRP = 0x00000000 // DeviceDesc (R/W)
   643  	SPDRP_HARDWAREID                  SPDRP = 0x00000001 // HardwareID (R/W)
   644  	SPDRP_COMPATIBLEIDS               SPDRP = 0x00000002 // CompatibleIDs (R/W)
   645  	SPDRP_SERVICE                     SPDRP = 0x00000004 // Service (R/W)
   646  	SPDRP_CLASS                       SPDRP = 0x00000007 // Class (R--tied to ClassGUID)
   647  	SPDRP_CLASSGUID                   SPDRP = 0x00000008 // ClassGUID (R/W)
   648  	SPDRP_DRIVER                      SPDRP = 0x00000009 // Driver (R/W)
   649  	SPDRP_CONFIGFLAGS                 SPDRP = 0x0000000A // ConfigFlags (R/W)
   650  	SPDRP_MFG                         SPDRP = 0x0000000B // Mfg (R/W)
   651  	SPDRP_FRIENDLYNAME                SPDRP = 0x0000000C // FriendlyName (R/W)
   652  	SPDRP_LOCATION_INFORMATION        SPDRP = 0x0000000D // LocationInformation (R/W)
   653  	SPDRP_PHYSICAL_DEVICE_OBJECT_NAME SPDRP = 0x0000000E // PhysicalDeviceObjectName (R)
   654  	SPDRP_CAPABILITIES                SPDRP = 0x0000000F // Capabilities (R)
   655  	SPDRP_UI_NUMBER                   SPDRP = 0x00000010 // UiNumber (R)
   656  	SPDRP_UPPERFILTERS                SPDRP = 0x00000011 // UpperFilters (R/W)
   657  	SPDRP_LOWERFILTERS                SPDRP = 0x00000012 // LowerFilters (R/W)
   658  	SPDRP_BUSTYPEGUID                 SPDRP = 0x00000013 // BusTypeGUID (R)
   659  	SPDRP_LEGACYBUSTYPE               SPDRP = 0x00000014 // LegacyBusType (R)
   660  	SPDRP_BUSNUMBER                   SPDRP = 0x00000015 // BusNumber (R)
   661  	SPDRP_ENUMERATOR_NAME             SPDRP = 0x00000016 // Enumerator Name (R)
   662  	SPDRP_SECURITY                    SPDRP = 0x00000017 // Security (R/W, binary form)
   663  	SPDRP_SECURITY_SDS                SPDRP = 0x00000018 // Security (W, SDS form)
   664  	SPDRP_DEVTYPE                     SPDRP = 0x00000019 // Device Type (R/W)
   665  	SPDRP_EXCLUSIVE                   SPDRP = 0x0000001A // Device is exclusive-access (R/W)
   666  	SPDRP_CHARACTERISTICS             SPDRP = 0x0000001B // Device Characteristics (R/W)
   667  	SPDRP_ADDRESS                     SPDRP = 0x0000001C // Device Address (R)
   668  	SPDRP_UI_NUMBER_DESC_FORMAT       SPDRP = 0x0000001D // UiNumberDescFormat (R/W)
   669  	SPDRP_DEVICE_POWER_DATA           SPDRP = 0x0000001E // Device Power Data (R)
   670  	SPDRP_REMOVAL_POLICY              SPDRP = 0x0000001F // Removal Policy (R)
   671  	SPDRP_REMOVAL_POLICY_HW_DEFAULT   SPDRP = 0x00000020 // Hardware Removal Policy (R)
   672  	SPDRP_REMOVAL_POLICY_OVERRIDE     SPDRP = 0x00000021 // Removal Policy Override (RW)
   673  	SPDRP_INSTALL_STATE               SPDRP = 0x00000022 // Device Install State (R)
   674  	SPDRP_LOCATION_PATHS              SPDRP = 0x00000023 // Device Location Paths (R)
   675  	SPDRP_BASE_CONTAINERID            SPDRP = 0x00000024 // Base ContainerID (R)
   676  
   677  	SPDRP_MAXIMUM_PROPERTY SPDRP = 0x00000025 // Upper bound on ordinals
   678  )
   679  
   680  // DEVPROPTYPE represents the property-data-type identifier that specifies the
   681  // data type of a device property value in the unified device property model.
   682  type DEVPROPTYPE uint32
   683  
   684  const (
   685  	DEVPROP_TYPEMOD_ARRAY DEVPROPTYPE = 0x00001000
   686  	DEVPROP_TYPEMOD_LIST  DEVPROPTYPE = 0x00002000
   687  
   688  	DEVPROP_TYPE_EMPTY                      DEVPROPTYPE = 0x00000000
   689  	DEVPROP_TYPE_NULL                       DEVPROPTYPE = 0x00000001
   690  	DEVPROP_TYPE_SBYTE                      DEVPROPTYPE = 0x00000002
   691  	DEVPROP_TYPE_BYTE                       DEVPROPTYPE = 0x00000003
   692  	DEVPROP_TYPE_INT16                      DEVPROPTYPE = 0x00000004
   693  	DEVPROP_TYPE_UINT16                     DEVPROPTYPE = 0x00000005
   694  	DEVPROP_TYPE_INT32                      DEVPROPTYPE = 0x00000006
   695  	DEVPROP_TYPE_UINT32                     DEVPROPTYPE = 0x00000007
   696  	DEVPROP_TYPE_INT64                      DEVPROPTYPE = 0x00000008
   697  	DEVPROP_TYPE_UINT64                     DEVPROPTYPE = 0x00000009
   698  	DEVPROP_TYPE_FLOAT                      DEVPROPTYPE = 0x0000000A
   699  	DEVPROP_TYPE_DOUBLE                     DEVPROPTYPE = 0x0000000B
   700  	DEVPROP_TYPE_DECIMAL                    DEVPROPTYPE = 0x0000000C
   701  	DEVPROP_TYPE_GUID                       DEVPROPTYPE = 0x0000000D
   702  	DEVPROP_TYPE_CURRENCY                   DEVPROPTYPE = 0x0000000E
   703  	DEVPROP_TYPE_DATE                       DEVPROPTYPE = 0x0000000F
   704  	DEVPROP_TYPE_FILETIME                   DEVPROPTYPE = 0x00000010
   705  	DEVPROP_TYPE_BOOLEAN                    DEVPROPTYPE = 0x00000011
   706  	DEVPROP_TYPE_STRING                     DEVPROPTYPE = 0x00000012
   707  	DEVPROP_TYPE_STRING_LIST                DEVPROPTYPE = DEVPROP_TYPE_STRING | DEVPROP_TYPEMOD_LIST
   708  	DEVPROP_TYPE_SECURITY_DESCRIPTOR        DEVPROPTYPE = 0x00000013
   709  	DEVPROP_TYPE_SECURITY_DESCRIPTOR_STRING DEVPROPTYPE = 0x00000014
   710  	DEVPROP_TYPE_DEVPROPKEY                 DEVPROPTYPE = 0x00000015
   711  	DEVPROP_TYPE_DEVPROPTYPE                DEVPROPTYPE = 0x00000016
   712  	DEVPROP_TYPE_BINARY                     DEVPROPTYPE = DEVPROP_TYPE_BYTE | DEVPROP_TYPEMOD_ARRAY
   713  	DEVPROP_TYPE_ERROR                      DEVPROPTYPE = 0x00000017
   714  	DEVPROP_TYPE_NTSTATUS                   DEVPROPTYPE = 0x00000018
   715  	DEVPROP_TYPE_STRING_INDIRECT            DEVPROPTYPE = 0x00000019
   716  
   717  	MAX_DEVPROP_TYPE    DEVPROPTYPE = 0x00000019
   718  	MAX_DEVPROP_TYPEMOD DEVPROPTYPE = 0x00002000
   719  
   720  	DEVPROP_MASK_TYPE    DEVPROPTYPE = 0x00000FFF
   721  	DEVPROP_MASK_TYPEMOD DEVPROPTYPE = 0x0000F000
   722  )
   723  
   724  // DEVPROPGUID specifies a property category.
   725  type DEVPROPGUID GUID
   726  
   727  // DEVPROPID uniquely identifies the property within the property category.
   728  type DEVPROPID uint32
   729  
   730  const DEVPROPID_FIRST_USABLE DEVPROPID = 2
   731  
   732  // DEVPROPKEY represents a device property key for a device property in the
   733  // unified device property model.
   734  type DEVPROPKEY struct {
   735  	FmtID DEVPROPGUID
   736  	PID   DEVPROPID
   737  }
   738  
   739  // CONFIGRET is a return value or error code from cfgmgr32 APIs
   740  type CONFIGRET uint32
   741  
   742  func (ret CONFIGRET) Error() string {
   743  	if win32Error, ok := ret.Unwrap().(Errno); ok {
   744  		return fmt.Sprintf("%s (CfgMgr error: 0x%08x)", win32Error.Error(), uint32(ret))
   745  	}
   746  	return fmt.Sprintf("CfgMgr error: 0x%08x", uint32(ret))
   747  }
   748  
   749  func (ret CONFIGRET) Win32Error(defaultError Errno) Errno {
   750  	return cm_MapCrToWin32Err(ret, defaultError)
   751  }
   752  
   753  func (ret CONFIGRET) Unwrap() error {
   754  	const noMatch = Errno(^uintptr(0))
   755  	win32Error := ret.Win32Error(noMatch)
   756  	if win32Error == noMatch {
   757  		return nil
   758  	}
   759  	return win32Error
   760  }
   761  
   762  const (
   763  	CR_SUCCESS                  CONFIGRET = 0x00000000
   764  	CR_DEFAULT                  CONFIGRET = 0x00000001
   765  	CR_OUT_OF_MEMORY            CONFIGRET = 0x00000002
   766  	CR_INVALID_POINTER          CONFIGRET = 0x00000003
   767  	CR_INVALID_FLAG             CONFIGRET = 0x00000004
   768  	CR_INVALID_DEVNODE          CONFIGRET = 0x00000005
   769  	CR_INVALID_DEVINST                    = CR_INVALID_DEVNODE
   770  	CR_INVALID_RES_DES          CONFIGRET = 0x00000006
   771  	CR_INVALID_LOG_CONF         CONFIGRET = 0x00000007
   772  	CR_INVALID_ARBITRATOR       CONFIGRET = 0x00000008
   773  	CR_INVALID_NODELIST         CONFIGRET = 0x00000009
   774  	CR_DEVNODE_HAS_REQS         CONFIGRET = 0x0000000A
   775  	CR_DEVINST_HAS_REQS                   = CR_DEVNODE_HAS_REQS
   776  	CR_INVALID_RESOURCEID       CONFIGRET = 0x0000000B
   777  	CR_DLVXD_NOT_FOUND          CONFIGRET = 0x0000000C
   778  	CR_NO_SUCH_DEVNODE          CONFIGRET = 0x0000000D
   779  	CR_NO_SUCH_DEVINST                    = CR_NO_SUCH_DEVNODE
   780  	CR_NO_MORE_LOG_CONF         CONFIGRET = 0x0000000E
   781  	CR_NO_MORE_RES_DES          CONFIGRET = 0x0000000F
   782  	CR_ALREADY_SUCH_DEVNODE     CONFIGRET = 0x00000010
   783  	CR_ALREADY_SUCH_DEVINST               = CR_ALREADY_SUCH_DEVNODE
   784  	CR_INVALID_RANGE_LIST       CONFIGRET = 0x00000011
   785  	CR_INVALID_RANGE            CONFIGRET = 0x00000012
   786  	CR_FAILURE                  CONFIGRET = 0x00000013
   787  	CR_NO_SUCH_LOGICAL_DEV      CONFIGRET = 0x00000014
   788  	CR_CREATE_BLOCKED           CONFIGRET = 0x00000015
   789  	CR_NOT_SYSTEM_VM            CONFIGRET = 0x00000016
   790  	CR_REMOVE_VETOED            CONFIGRET = 0x00000017
   791  	CR_APM_VETOED               CONFIGRET = 0x00000018
   792  	CR_INVALID_LOAD_TYPE        CONFIGRET = 0x00000019
   793  	CR_BUFFER_SMALL             CONFIGRET = 0x0000001A
   794  	CR_NO_ARBITRATOR            CONFIGRET = 0x0000001B
   795  	CR_NO_REGISTRY_HANDLE       CONFIGRET = 0x0000001C
   796  	CR_REGISTRY_ERROR           CONFIGRET = 0x0000001D
   797  	CR_INVALID_DEVICE_ID        CONFIGRET = 0x0000001E
   798  	CR_INVALID_DATA             CONFIGRET = 0x0000001F
   799  	CR_INVALID_API              CONFIGRET = 0x00000020
   800  	CR_DEVLOADER_NOT_READY      CONFIGRET = 0x00000021
   801  	CR_NEED_RESTART             CONFIGRET = 0x00000022
   802  	CR_NO_MORE_HW_PROFILES      CONFIGRET = 0x00000023
   803  	CR_DEVICE_NOT_THERE         CONFIGRET = 0x00000024
   804  	CR_NO_SUCH_VALUE            CONFIGRET = 0x00000025
   805  	CR_WRONG_TYPE               CONFIGRET = 0x00000026
   806  	CR_INVALID_PRIORITY         CONFIGRET = 0x00000027
   807  	CR_NOT_DISABLEABLE          CONFIGRET = 0x00000028
   808  	CR_FREE_RESOURCES           CONFIGRET = 0x00000029
   809  	CR_QUERY_VETOED             CONFIGRET = 0x0000002A
   810  	CR_CANT_SHARE_IRQ           CONFIGRET = 0x0000002B
   811  	CR_NO_DEPENDENT             CONFIGRET = 0x0000002C
   812  	CR_SAME_RESOURCES           CONFIGRET = 0x0000002D
   813  	CR_NO_SUCH_REGISTRY_KEY     CONFIGRET = 0x0000002E
   814  	CR_INVALID_MACHINENAME      CONFIGRET = 0x0000002F
   815  	CR_REMOTE_COMM_FAILURE      CONFIGRET = 0x00000030
   816  	CR_MACHINE_UNAVAILABLE      CONFIGRET = 0x00000031
   817  	CR_NO_CM_SERVICES           CONFIGRET = 0x00000032
   818  	CR_ACCESS_DENIED            CONFIGRET = 0x00000033
   819  	CR_CALL_NOT_IMPLEMENTED     CONFIGRET = 0x00000034
   820  	CR_INVALID_PROPERTY         CONFIGRET = 0x00000035
   821  	CR_DEVICE_INTERFACE_ACTIVE  CONFIGRET = 0x00000036
   822  	CR_NO_SUCH_DEVICE_INTERFACE CONFIGRET = 0x00000037
   823  	CR_INVALID_REFERENCE_STRING CONFIGRET = 0x00000038
   824  	CR_INVALID_CONFLICT_LIST    CONFIGRET = 0x00000039
   825  	CR_INVALID_INDEX            CONFIGRET = 0x0000003A
   826  	CR_INVALID_STRUCTURE_SIZE   CONFIGRET = 0x0000003B
   827  	NUM_CR_RESULTS              CONFIGRET = 0x0000003C
   828  )
   829  
   830  const (
   831  	CM_GET_DEVICE_INTERFACE_LIST_PRESENT     = 0 // only currently 'live' device interfaces
   832  	CM_GET_DEVICE_INTERFACE_LIST_ALL_DEVICES = 1 // all registered device interfaces, live or not
   833  )
   834  
   835  const (
   836  	DN_ROOT_ENUMERATED       = 0x00000001        // Was enumerated by ROOT
   837  	DN_DRIVER_LOADED         = 0x00000002        // Has Register_Device_Driver
   838  	DN_ENUM_LOADED           = 0x00000004        // Has Register_Enumerator
   839  	DN_STARTED               = 0x00000008        // Is currently configured
   840  	DN_MANUAL                = 0x00000010        // Manually installed
   841  	DN_NEED_TO_ENUM          = 0x00000020        // May need reenumeration
   842  	DN_NOT_FIRST_TIME        = 0x00000040        // Has received a config
   843  	DN_HARDWARE_ENUM         = 0x00000080        // Enum generates hardware ID
   844  	DN_LIAR                  = 0x00000100        // Lied about can reconfig once
   845  	DN_HAS_MARK              = 0x00000200        // Not CM_Create_DevInst lately
   846  	DN_HAS_PROBLEM           = 0x00000400        // Need device installer
   847  	DN_FILTERED              = 0x00000800        // Is filtered
   848  	DN_MOVED                 = 0x00001000        // Has been moved
   849  	DN_DISABLEABLE           = 0x00002000        // Can be disabled
   850  	DN_REMOVABLE             = 0x00004000        // Can be removed
   851  	DN_PRIVATE_PROBLEM       = 0x00008000        // Has a private problem
   852  	DN_MF_PARENT             = 0x00010000        // Multi function parent
   853  	DN_MF_CHILD              = 0x00020000        // Multi function child
   854  	DN_WILL_BE_REMOVED       = 0x00040000        // DevInst is being removed
   855  	DN_NOT_FIRST_TIMEE       = 0x00080000        // Has received a config enumerate
   856  	DN_STOP_FREE_RES         = 0x00100000        // When child is stopped, free resources
   857  	DN_REBAL_CANDIDATE       = 0x00200000        // Don't skip during rebalance
   858  	DN_BAD_PARTIAL           = 0x00400000        // This devnode's log_confs do not have same resources
   859  	DN_NT_ENUMERATOR         = 0x00800000        // This devnode's is an NT enumerator
   860  	DN_NT_DRIVER             = 0x01000000        // This devnode's is an NT driver
   861  	DN_NEEDS_LOCKING         = 0x02000000        // Devnode need lock resume processing
   862  	DN_ARM_WAKEUP            = 0x04000000        // Devnode can be the wakeup device
   863  	DN_APM_ENUMERATOR        = 0x08000000        // APM aware enumerator
   864  	DN_APM_DRIVER            = 0x10000000        // APM aware driver
   865  	DN_SILENT_INSTALL        = 0x20000000        // Silent install
   866  	DN_NO_SHOW_IN_DM         = 0x40000000        // No show in device manager
   867  	DN_BOOT_LOG_PROB         = 0x80000000        // Had a problem during preassignment of boot log conf
   868  	DN_NEED_RESTART          = DN_LIAR           // System needs to be restarted for this Devnode to work properly
   869  	DN_DRIVER_BLOCKED        = DN_NOT_FIRST_TIME // One or more drivers are blocked from loading for this Devnode
   870  	DN_LEGACY_DRIVER         = DN_MOVED          // This device is using a legacy driver
   871  	DN_CHILD_WITH_INVALID_ID = DN_HAS_MARK       // One or more children have invalid IDs
   872  	DN_DEVICE_DISCONNECTED   = DN_NEEDS_LOCKING  // The function driver for a device reported that the device is not connected.  Typically this means a wireless device is out of range.
   873  	DN_QUERY_REMOVE_PENDING  = DN_MF_PARENT      // Device is part of a set of related devices collectively pending query-removal
   874  	DN_QUERY_REMOVE_ACTIVE   = DN_MF_CHILD       // Device is actively engaged in a query-remove IRP
   875  	DN_CHANGEABLE_FLAGS      = DN_NOT_FIRST_TIME | DN_HARDWARE_ENUM | DN_HAS_MARK | DN_DISABLEABLE | DN_REMOVABLE | DN_MF_CHILD | DN_MF_PARENT | DN_NOT_FIRST_TIMEE | DN_STOP_FREE_RES | DN_REBAL_CANDIDATE | DN_NT_ENUMERATOR | DN_NT_DRIVER | DN_SILENT_INSTALL | DN_NO_SHOW_IN_DM
   876  )
   877  
   878  //sys	setupDiCreateDeviceInfoListEx(classGUID *GUID, hwndParent uintptr, machineName *uint16, reserved uintptr) (handle DevInfo, err error) [failretval==DevInfo(InvalidHandle)] = setupapi.SetupDiCreateDeviceInfoListExW
   879  
   880  // SetupDiCreateDeviceInfoListEx function creates an empty device information set on a remote or a local computer and optionally associates the set with a device setup class.
   881  func SetupDiCreateDeviceInfoListEx(classGUID *GUID, hwndParent uintptr, machineName string) (deviceInfoSet DevInfo, err error) {
   882  	var machineNameUTF16 *uint16
   883  	if machineName != "" {
   884  		machineNameUTF16, err = UTF16PtrFromString(machineName)
   885  		if err != nil {
   886  			return
   887  		}
   888  	}
   889  	return setupDiCreateDeviceInfoListEx(classGUID, hwndParent, machineNameUTF16, 0)
   890  }
   891  
   892  //sys	setupDiGetDeviceInfoListDetail(deviceInfoSet DevInfo, deviceInfoSetDetailData *DevInfoListDetailData) (err error) = setupapi.SetupDiGetDeviceInfoListDetailW
   893  
   894  // SetupDiGetDeviceInfoListDetail function retrieves information associated with a device information set including the class GUID, remote computer handle, and remote computer name.
   895  func SetupDiGetDeviceInfoListDetail(deviceInfoSet DevInfo) (deviceInfoSetDetailData *DevInfoListDetailData, err error) {
   896  	data := &DevInfoListDetailData{}
   897  	data.size = data.unsafeSizeOf()
   898  
   899  	return data, setupDiGetDeviceInfoListDetail(deviceInfoSet, data)
   900  }
   901  
   902  // DeviceInfoListDetail method retrieves information associated with a device information set including the class GUID, remote computer handle, and remote computer name.
   903  func (deviceInfoSet DevInfo) DeviceInfoListDetail() (*DevInfoListDetailData, error) {
   904  	return SetupDiGetDeviceInfoListDetail(deviceInfoSet)
   905  }
   906  
   907  //sys	setupDiCreateDeviceInfo(deviceInfoSet DevInfo, DeviceName *uint16, classGUID *GUID, DeviceDescription *uint16, hwndParent uintptr, CreationFlags DICD, deviceInfoData *DevInfoData) (err error) = setupapi.SetupDiCreateDeviceInfoW
   908  
   909  // SetupDiCreateDeviceInfo function creates a new device information element and adds it as a new member to the specified device information set.
   910  func SetupDiCreateDeviceInfo(deviceInfoSet DevInfo, deviceName string, classGUID *GUID, deviceDescription string, hwndParent uintptr, creationFlags DICD) (deviceInfoData *DevInfoData, err error) {
   911  	deviceNameUTF16, err := UTF16PtrFromString(deviceName)
   912  	if err != nil {
   913  		return
   914  	}
   915  
   916  	var deviceDescriptionUTF16 *uint16
   917  	if deviceDescription != "" {
   918  		deviceDescriptionUTF16, err = UTF16PtrFromString(deviceDescription)
   919  		if err != nil {
   920  			return
   921  		}
   922  	}
   923  
   924  	data := &DevInfoData{}
   925  	data.size = uint32(unsafe.Sizeof(*data))
   926  
   927  	return data, setupDiCreateDeviceInfo(deviceInfoSet, deviceNameUTF16, classGUID, deviceDescriptionUTF16, hwndParent, creationFlags, data)
   928  }
   929  
   930  // CreateDeviceInfo method creates a new device information element and adds it as a new member to the specified device information set.
   931  func (deviceInfoSet DevInfo) CreateDeviceInfo(deviceName string, classGUID *GUID, deviceDescription string, hwndParent uintptr, creationFlags DICD) (*DevInfoData, error) {
   932  	return SetupDiCreateDeviceInfo(deviceInfoSet, deviceName, classGUID, deviceDescription, hwndParent, creationFlags)
   933  }
   934  
   935  //sys	setupDiEnumDeviceInfo(deviceInfoSet DevInfo, memberIndex uint32, deviceInfoData *DevInfoData) (err error) = setupapi.SetupDiEnumDeviceInfo
   936  
   937  // SetupDiEnumDeviceInfo function returns a DevInfoData structure that specifies a device information element in a device information set.
   938  func SetupDiEnumDeviceInfo(deviceInfoSet DevInfo, memberIndex int) (*DevInfoData, error) {
   939  	data := &DevInfoData{}
   940  	data.size = uint32(unsafe.Sizeof(*data))
   941  
   942  	return data, setupDiEnumDeviceInfo(deviceInfoSet, uint32(memberIndex), data)
   943  }
   944  
   945  // EnumDeviceInfo method returns a DevInfoData structure that specifies a device information element in a device information set.
   946  func (deviceInfoSet DevInfo) EnumDeviceInfo(memberIndex int) (*DevInfoData, error) {
   947  	return SetupDiEnumDeviceInfo(deviceInfoSet, memberIndex)
   948  }
   949  
   950  // SetupDiDestroyDeviceInfoList function deletes a device information set and frees all associated memory.
   951  //sys	SetupDiDestroyDeviceInfoList(deviceInfoSet DevInfo) (err error) = setupapi.SetupDiDestroyDeviceInfoList
   952  
   953  // Close method deletes a device information set and frees all associated memory.
   954  func (deviceInfoSet DevInfo) Close() error {
   955  	return SetupDiDestroyDeviceInfoList(deviceInfoSet)
   956  }
   957  
   958  //sys	SetupDiBuildDriverInfoList(deviceInfoSet DevInfo, deviceInfoData *DevInfoData, driverType SPDIT) (err error) = setupapi.SetupDiBuildDriverInfoList
   959  
   960  // BuildDriverInfoList method builds a list of drivers that is associated with a specific device or with the global class driver list for a device information set.
   961  func (deviceInfoSet DevInfo) BuildDriverInfoList(deviceInfoData *DevInfoData, driverType SPDIT) error {
   962  	return SetupDiBuildDriverInfoList(deviceInfoSet, deviceInfoData, driverType)
   963  }
   964  
   965  //sys	SetupDiCancelDriverInfoSearch(deviceInfoSet DevInfo) (err error) = setupapi.SetupDiCancelDriverInfoSearch
   966  
   967  // CancelDriverInfoSearch method cancels a driver list search that is currently in progress in a different thread.
   968  func (deviceInfoSet DevInfo) CancelDriverInfoSearch() error {
   969  	return SetupDiCancelDriverInfoSearch(deviceInfoSet)
   970  }
   971  
   972  //sys	setupDiEnumDriverInfo(deviceInfoSet DevInfo, deviceInfoData *DevInfoData, driverType SPDIT, memberIndex uint32, driverInfoData *DrvInfoData) (err error) = setupapi.SetupDiEnumDriverInfoW
   973  
   974  // SetupDiEnumDriverInfo function enumerates the members of a driver list.
   975  func SetupDiEnumDriverInfo(deviceInfoSet DevInfo, deviceInfoData *DevInfoData, driverType SPDIT, memberIndex int) (*DrvInfoData, error) {
   976  	data := &DrvInfoData{}
   977  	data.size = uint32(unsafe.Sizeof(*data))
   978  
   979  	return data, setupDiEnumDriverInfo(deviceInfoSet, deviceInfoData, driverType, uint32(memberIndex), data)
   980  }
   981  
   982  // EnumDriverInfo method enumerates the members of a driver list.
   983  func (deviceInfoSet DevInfo) EnumDriverInfo(deviceInfoData *DevInfoData, driverType SPDIT, memberIndex int) (*DrvInfoData, error) {
   984  	return SetupDiEnumDriverInfo(deviceInfoSet, deviceInfoData, driverType, memberIndex)
   985  }
   986  
   987  //sys	setupDiGetSelectedDriver(deviceInfoSet DevInfo, deviceInfoData *DevInfoData, driverInfoData *DrvInfoData) (err error) = setupapi.SetupDiGetSelectedDriverW
   988  
   989  // SetupDiGetSelectedDriver function retrieves the selected driver for a device information set or a particular device information element.
   990  func SetupDiGetSelectedDriver(deviceInfoSet DevInfo, deviceInfoData *DevInfoData) (*DrvInfoData, error) {
   991  	data := &DrvInfoData{}
   992  	data.size = uint32(unsafe.Sizeof(*data))
   993  
   994  	return data, setupDiGetSelectedDriver(deviceInfoSet, deviceInfoData, data)
   995  }
   996  
   997  // SelectedDriver method retrieves the selected driver for a device information set or a particular device information element.
   998  func (deviceInfoSet DevInfo) SelectedDriver(deviceInfoData *DevInfoData) (*DrvInfoData, error) {
   999  	return SetupDiGetSelectedDriver(deviceInfoSet, deviceInfoData)
  1000  }
  1001  
  1002  //sys	SetupDiSetSelectedDriver(deviceInfoSet DevInfo, deviceInfoData *DevInfoData, driverInfoData *DrvInfoData) (err error) = setupapi.SetupDiSetSelectedDriverW
  1003  
  1004  // SetSelectedDriver method sets, or resets, the selected driver for a device information element or the selected class driver for a device information set.
  1005  func (deviceInfoSet DevInfo) SetSelectedDriver(deviceInfoData *DevInfoData, driverInfoData *DrvInfoData) error {
  1006  	return SetupDiSetSelectedDriver(deviceInfoSet, deviceInfoData, driverInfoData)
  1007  }
  1008  
  1009  //sys	setupDiGetDriverInfoDetail(deviceInfoSet DevInfo, deviceInfoData *DevInfoData, driverInfoData *DrvInfoData, driverInfoDetailData *DrvInfoDetailData, driverInfoDetailDataSize uint32, requiredSize *uint32) (err error) = setupapi.SetupDiGetDriverInfoDetailW
  1010  
  1011  // SetupDiGetDriverInfoDetail function retrieves driver information detail for a device information set or a particular device information element in the device information set.
  1012  func SetupDiGetDriverInfoDetail(deviceInfoSet DevInfo, deviceInfoData *DevInfoData, driverInfoData *DrvInfoData) (*DrvInfoDetailData, error) {
  1013  	reqSize := uint32(2048)
  1014  	for {
  1015  		buf := make([]byte, reqSize)
  1016  		data := (*DrvInfoDetailData)(unsafe.Pointer(&buf[0]))
  1017  		data.size = data.unsafeSizeOf()
  1018  		err := setupDiGetDriverInfoDetail(deviceInfoSet, deviceInfoData, driverInfoData, data, uint32(len(buf)), &reqSize)
  1019  		if err == ERROR_INSUFFICIENT_BUFFER {
  1020  			continue
  1021  		}
  1022  		if err != nil {
  1023  			return nil, err
  1024  		}
  1025  		data.size = reqSize
  1026  		return data, nil
  1027  	}
  1028  }
  1029  
  1030  // DriverInfoDetail method retrieves driver information detail for a device information set or a particular device information element in the device information set.
  1031  func (deviceInfoSet DevInfo) DriverInfoDetail(deviceInfoData *DevInfoData, driverInfoData *DrvInfoData) (*DrvInfoDetailData, error) {
  1032  	return SetupDiGetDriverInfoDetail(deviceInfoSet, deviceInfoData, driverInfoData)
  1033  }
  1034  
  1035  //sys	SetupDiDestroyDriverInfoList(deviceInfoSet DevInfo, deviceInfoData *DevInfoData, driverType SPDIT) (err error) = setupapi.SetupDiDestroyDriverInfoList
  1036  
  1037  // DestroyDriverInfoList method deletes a driver list.
  1038  func (deviceInfoSet DevInfo) DestroyDriverInfoList(deviceInfoData *DevInfoData, driverType SPDIT) error {
  1039  	return SetupDiDestroyDriverInfoList(deviceInfoSet, deviceInfoData, driverType)
  1040  }
  1041  
  1042  //sys	setupDiGetClassDevsEx(classGUID *GUID, Enumerator *uint16, hwndParent uintptr, Flags DIGCF, deviceInfoSet DevInfo, machineName *uint16, reserved uintptr) (handle DevInfo, err error) [failretval==DevInfo(InvalidHandle)] = setupapi.SetupDiGetClassDevsExW
  1043  
  1044  // SetupDiGetClassDevsEx function returns a handle to a device information set that contains requested device information elements for a local or a remote computer.
  1045  func SetupDiGetClassDevsEx(classGUID *GUID, enumerator string, hwndParent uintptr, flags DIGCF, deviceInfoSet DevInfo, machineName string) (handle DevInfo, err error) {
  1046  	var enumeratorUTF16 *uint16
  1047  	if enumerator != "" {
  1048  		enumeratorUTF16, err = UTF16PtrFromString(enumerator)
  1049  		if err != nil {
  1050  			return
  1051  		}
  1052  	}
  1053  	var machineNameUTF16 *uint16
  1054  	if machineName != "" {
  1055  		machineNameUTF16, err = UTF16PtrFromString(machineName)
  1056  		if err != nil {
  1057  			return
  1058  		}
  1059  	}
  1060  	return setupDiGetClassDevsEx(classGUID, enumeratorUTF16, hwndParent, flags, deviceInfoSet, machineNameUTF16, 0)
  1061  }
  1062  
  1063  // SetupDiCallClassInstaller function calls the appropriate class installer, and any registered co-installers, with the specified installation request (DIF code).
  1064  //sys	SetupDiCallClassInstaller(installFunction DI_FUNCTION, deviceInfoSet DevInfo, deviceInfoData *DevInfoData) (err error) = setupapi.SetupDiCallClassInstaller
  1065  
  1066  // CallClassInstaller member calls the appropriate class installer, and any registered co-installers, with the specified installation request (DIF code).
  1067  func (deviceInfoSet DevInfo) CallClassInstaller(installFunction DI_FUNCTION, deviceInfoData *DevInfoData) error {
  1068  	return SetupDiCallClassInstaller(installFunction, deviceInfoSet, deviceInfoData)
  1069  }
  1070  
  1071  // SetupDiOpenDevRegKey function opens a registry key for device-specific configuration information.
  1072  //sys	SetupDiOpenDevRegKey(deviceInfoSet DevInfo, deviceInfoData *DevInfoData, Scope DICS_FLAG, HwProfile uint32, KeyType DIREG, samDesired uint32) (key Handle, err error) [failretval==InvalidHandle] = setupapi.SetupDiOpenDevRegKey
  1073  
  1074  // OpenDevRegKey method opens a registry key for device-specific configuration information.
  1075  func (deviceInfoSet DevInfo) OpenDevRegKey(DeviceInfoData *DevInfoData, Scope DICS_FLAG, HwProfile uint32, KeyType DIREG, samDesired uint32) (Handle, error) {
  1076  	return SetupDiOpenDevRegKey(deviceInfoSet, DeviceInfoData, Scope, HwProfile, KeyType, samDesired)
  1077  }
  1078  
  1079  //sys	setupDiGetDeviceProperty(deviceInfoSet DevInfo, deviceInfoData *DevInfoData, propertyKey *DEVPROPKEY, propertyType *DEVPROPTYPE, propertyBuffer *byte, propertyBufferSize uint32, requiredSize *uint32, flags uint32) (err error) = setupapi.SetupDiGetDevicePropertyW
  1080  
  1081  // SetupDiGetDeviceProperty function retrieves a specified device instance property.
  1082  func SetupDiGetDeviceProperty(deviceInfoSet DevInfo, deviceInfoData *DevInfoData, propertyKey *DEVPROPKEY) (value interface{}, err error) {
  1083  	reqSize := uint32(256)
  1084  	for {
  1085  		var dataType DEVPROPTYPE
  1086  		buf := make([]byte, reqSize)
  1087  		err = setupDiGetDeviceProperty(deviceInfoSet, deviceInfoData, propertyKey, &dataType, &buf[0], uint32(len(buf)), &reqSize, 0)
  1088  		if err == ERROR_INSUFFICIENT_BUFFER {
  1089  			continue
  1090  		}
  1091  		if err != nil {
  1092  			return
  1093  		}
  1094  		switch dataType {
  1095  		case DEVPROP_TYPE_STRING:
  1096  			ret := UTF16ToString(bufToUTF16(buf))
  1097  			runtime.KeepAlive(buf)
  1098  			return ret, nil
  1099  		}
  1100  		return nil, errors.New("unimplemented property type")
  1101  	}
  1102  }
  1103  
  1104  //sys	setupDiGetDeviceRegistryProperty(deviceInfoSet DevInfo, deviceInfoData *DevInfoData, property SPDRP, propertyRegDataType *uint32, propertyBuffer *byte, propertyBufferSize uint32, requiredSize *uint32) (err error) = setupapi.SetupDiGetDeviceRegistryPropertyW
  1105  
  1106  // SetupDiGetDeviceRegistryProperty function retrieves a specified Plug and Play device property.
  1107  func SetupDiGetDeviceRegistryProperty(deviceInfoSet DevInfo, deviceInfoData *DevInfoData, property SPDRP) (value interface{}, err error) {
  1108  	reqSize := uint32(256)
  1109  	for {
  1110  		var dataType uint32
  1111  		buf := make([]byte, reqSize)
  1112  		err = setupDiGetDeviceRegistryProperty(deviceInfoSet, deviceInfoData, property, &dataType, &buf[0], uint32(len(buf)), &reqSize)
  1113  		if err == ERROR_INSUFFICIENT_BUFFER {
  1114  			continue
  1115  		}
  1116  		if err != nil {
  1117  			return
  1118  		}
  1119  		return getRegistryValue(buf[:reqSize], dataType)
  1120  	}
  1121  }
  1122  
  1123  func getRegistryValue(buf []byte, dataType uint32) (interface{}, error) {
  1124  	switch dataType {
  1125  	case REG_SZ:
  1126  		ret := UTF16ToString(bufToUTF16(buf))
  1127  		runtime.KeepAlive(buf)
  1128  		return ret, nil
  1129  	case REG_EXPAND_SZ:
  1130  		value := UTF16ToString(bufToUTF16(buf))
  1131  		if value == "" {
  1132  			return "", nil
  1133  		}
  1134  		p, err := syscall.UTF16PtrFromString(value)
  1135  		if err != nil {
  1136  			return "", err
  1137  		}
  1138  		ret := make([]uint16, 100)
  1139  		for {
  1140  			n, err := ExpandEnvironmentStrings(p, &ret[0], uint32(len(ret)))
  1141  			if err != nil {
  1142  				return "", err
  1143  			}
  1144  			if n <= uint32(len(ret)) {
  1145  				return UTF16ToString(ret[:n]), nil
  1146  			}
  1147  			ret = make([]uint16, n)
  1148  		}
  1149  	case REG_BINARY:
  1150  		return buf, nil
  1151  	case REG_DWORD_LITTLE_ENDIAN:
  1152  		return binary.LittleEndian.Uint32(buf), nil
  1153  	case REG_DWORD_BIG_ENDIAN:
  1154  		return binary.BigEndian.Uint32(buf), nil
  1155  	case REG_MULTI_SZ:
  1156  		bufW := bufToUTF16(buf)
  1157  		a := []string{}
  1158  		for i := 0; i < len(bufW); {
  1159  			j := i + wcslen(bufW[i:])
  1160  			if i < j {
  1161  				a = append(a, UTF16ToString(bufW[i:j]))
  1162  			}
  1163  			i = j + 1
  1164  		}
  1165  		runtime.KeepAlive(buf)
  1166  		return a, nil
  1167  	case REG_QWORD_LITTLE_ENDIAN:
  1168  		return binary.LittleEndian.Uint64(buf), nil
  1169  	default:
  1170  		return nil, fmt.Errorf("Unsupported registry value type: %v", dataType)
  1171  	}
  1172  }
  1173  
  1174  // bufToUTF16 function reinterprets []byte buffer as []uint16
  1175  func bufToUTF16(buf []byte) []uint16 {
  1176  	sl := struct {
  1177  		addr *uint16
  1178  		len  int
  1179  		cap  int
  1180  	}{(*uint16)(unsafe.Pointer(&buf[0])), len(buf) / 2, cap(buf) / 2}
  1181  	return *(*[]uint16)(unsafe.Pointer(&sl))
  1182  }
  1183  
  1184  // utf16ToBuf function reinterprets []uint16 as []byte
  1185  func utf16ToBuf(buf []uint16) []byte {
  1186  	sl := struct {
  1187  		addr *byte
  1188  		len  int
  1189  		cap  int
  1190  	}{(*byte)(unsafe.Pointer(&buf[0])), len(buf) * 2, cap(buf) * 2}
  1191  	return *(*[]byte)(unsafe.Pointer(&sl))
  1192  }
  1193  
  1194  func wcslen(str []uint16) int {
  1195  	for i := 0; i < len(str); i++ {
  1196  		if str[i] == 0 {
  1197  			return i
  1198  		}
  1199  	}
  1200  	return len(str)
  1201  }
  1202  
  1203  // DeviceRegistryProperty method retrieves a specified Plug and Play device property.
  1204  func (deviceInfoSet DevInfo) DeviceRegistryProperty(deviceInfoData *DevInfoData, property SPDRP) (interface{}, error) {
  1205  	return SetupDiGetDeviceRegistryProperty(deviceInfoSet, deviceInfoData, property)
  1206  }
  1207  
  1208  //sys	setupDiSetDeviceRegistryProperty(deviceInfoSet DevInfo, deviceInfoData *DevInfoData, property SPDRP, propertyBuffer *byte, propertyBufferSize uint32) (err error) = setupapi.SetupDiSetDeviceRegistryPropertyW
  1209  
  1210  // SetupDiSetDeviceRegistryProperty function sets a Plug and Play device property for a device.
  1211  func SetupDiSetDeviceRegistryProperty(deviceInfoSet DevInfo, deviceInfoData *DevInfoData, property SPDRP, propertyBuffers []byte) error {
  1212  	return setupDiSetDeviceRegistryProperty(deviceInfoSet, deviceInfoData, property, &propertyBuffers[0], uint32(len(propertyBuffers)))
  1213  }
  1214  
  1215  // SetDeviceRegistryProperty function sets a Plug and Play device property for a device.
  1216  func (deviceInfoSet DevInfo) SetDeviceRegistryProperty(deviceInfoData *DevInfoData, property SPDRP, propertyBuffers []byte) error {
  1217  	return SetupDiSetDeviceRegistryProperty(deviceInfoSet, deviceInfoData, property, propertyBuffers)
  1218  }
  1219  
  1220  // SetDeviceRegistryPropertyString method sets a Plug and Play device property string for a device.
  1221  func (deviceInfoSet DevInfo) SetDeviceRegistryPropertyString(deviceInfoData *DevInfoData, property SPDRP, str string) error {
  1222  	str16, err := UTF16FromString(str)
  1223  	if err != nil {
  1224  		return err
  1225  	}
  1226  	err = SetupDiSetDeviceRegistryProperty(deviceInfoSet, deviceInfoData, property, utf16ToBuf(append(str16, 0)))
  1227  	runtime.KeepAlive(str16)
  1228  	return err
  1229  }
  1230  
  1231  //sys	setupDiGetDeviceInstallParams(deviceInfoSet DevInfo, deviceInfoData *DevInfoData, deviceInstallParams *DevInstallParams) (err error) = setupapi.SetupDiGetDeviceInstallParamsW
  1232  
  1233  // SetupDiGetDeviceInstallParams function retrieves device installation parameters for a device information set or a particular device information element.
  1234  func SetupDiGetDeviceInstallParams(deviceInfoSet DevInfo, deviceInfoData *DevInfoData) (*DevInstallParams, error) {
  1235  	params := &DevInstallParams{}
  1236  	params.size = uint32(unsafe.Sizeof(*params))
  1237  
  1238  	return params, setupDiGetDeviceInstallParams(deviceInfoSet, deviceInfoData, params)
  1239  }
  1240  
  1241  // DeviceInstallParams method retrieves device installation parameters for a device information set or a particular device information element.
  1242  func (deviceInfoSet DevInfo) DeviceInstallParams(deviceInfoData *DevInfoData) (*DevInstallParams, error) {
  1243  	return SetupDiGetDeviceInstallParams(deviceInfoSet, deviceInfoData)
  1244  }
  1245  
  1246  //sys	setupDiGetDeviceInstanceId(deviceInfoSet DevInfo, deviceInfoData *DevInfoData, instanceId *uint16, instanceIdSize uint32, instanceIdRequiredSize *uint32) (err error) = setupapi.SetupDiGetDeviceInstanceIdW
  1247  
  1248  // SetupDiGetDeviceInstanceId function retrieves the instance ID of the device.
  1249  func SetupDiGetDeviceInstanceId(deviceInfoSet DevInfo, deviceInfoData *DevInfoData) (string, error) {
  1250  	reqSize := uint32(1024)
  1251  	for {
  1252  		buf := make([]uint16, reqSize)
  1253  		err := setupDiGetDeviceInstanceId(deviceInfoSet, deviceInfoData, &buf[0], uint32(len(buf)), &reqSize)
  1254  		if err == ERROR_INSUFFICIENT_BUFFER {
  1255  			continue
  1256  		}
  1257  		if err != nil {
  1258  			return "", err
  1259  		}
  1260  		return UTF16ToString(buf), nil
  1261  	}
  1262  }
  1263  
  1264  // DeviceInstanceID method retrieves the instance ID of the device.
  1265  func (deviceInfoSet DevInfo) DeviceInstanceID(deviceInfoData *DevInfoData) (string, error) {
  1266  	return SetupDiGetDeviceInstanceId(deviceInfoSet, deviceInfoData)
  1267  }
  1268  
  1269  // SetupDiGetClassInstallParams function retrieves class installation parameters for a device information set or a particular device information element.
  1270  //sys	SetupDiGetClassInstallParams(deviceInfoSet DevInfo, deviceInfoData *DevInfoData, classInstallParams *ClassInstallHeader, classInstallParamsSize uint32, requiredSize *uint32) (err error) = setupapi.SetupDiGetClassInstallParamsW
  1271  
  1272  // ClassInstallParams method retrieves class installation parameters for a device information set or a particular device information element.
  1273  func (deviceInfoSet DevInfo) ClassInstallParams(deviceInfoData *DevInfoData, classInstallParams *ClassInstallHeader, classInstallParamsSize uint32, requiredSize *uint32) error {
  1274  	return SetupDiGetClassInstallParams(deviceInfoSet, deviceInfoData, classInstallParams, classInstallParamsSize, requiredSize)
  1275  }
  1276  
  1277  //sys	SetupDiSetDeviceInstallParams(deviceInfoSet DevInfo, deviceInfoData *DevInfoData, deviceInstallParams *DevInstallParams) (err error) = setupapi.SetupDiSetDeviceInstallParamsW
  1278  
  1279  // SetDeviceInstallParams member sets device installation parameters for a device information set or a particular device information element.
  1280  func (deviceInfoSet DevInfo) SetDeviceInstallParams(deviceInfoData *DevInfoData, deviceInstallParams *DevInstallParams) error {
  1281  	return SetupDiSetDeviceInstallParams(deviceInfoSet, deviceInfoData, deviceInstallParams)
  1282  }
  1283  
  1284  // SetupDiSetClassInstallParams function sets or clears class install parameters for a device information set or a particular device information element.
  1285  //sys	SetupDiSetClassInstallParams(deviceInfoSet DevInfo, deviceInfoData *DevInfoData, classInstallParams *ClassInstallHeader, classInstallParamsSize uint32) (err error) = setupapi.SetupDiSetClassInstallParamsW
  1286  
  1287  // SetClassInstallParams method sets or clears class install parameters for a device information set or a particular device information element.
  1288  func (deviceInfoSet DevInfo) SetClassInstallParams(deviceInfoData *DevInfoData, classInstallParams *ClassInstallHeader, classInstallParamsSize uint32) error {
  1289  	return SetupDiSetClassInstallParams(deviceInfoSet, deviceInfoData, classInstallParams, classInstallParamsSize)
  1290  }
  1291  
  1292  //sys	setupDiClassNameFromGuidEx(classGUID *GUID, className *uint16, classNameSize uint32, requiredSize *uint32, machineName *uint16, reserved uintptr) (err error) = setupapi.SetupDiClassNameFromGuidExW
  1293  
  1294  // SetupDiClassNameFromGuidEx function retrieves the class name associated with a class GUID. The class can be installed on a local or remote computer.
  1295  func SetupDiClassNameFromGuidEx(classGUID *GUID, machineName string) (className string, err error) {
  1296  	var classNameUTF16 [MAX_CLASS_NAME_LEN]uint16
  1297  
  1298  	var machineNameUTF16 *uint16
  1299  	if machineName != "" {
  1300  		machineNameUTF16, err = UTF16PtrFromString(machineName)
  1301  		if err != nil {
  1302  			return
  1303  		}
  1304  	}
  1305  
  1306  	err = setupDiClassNameFromGuidEx(classGUID, &classNameUTF16[0], MAX_CLASS_NAME_LEN, nil, machineNameUTF16, 0)
  1307  	if err != nil {
  1308  		return
  1309  	}
  1310  
  1311  	className = UTF16ToString(classNameUTF16[:])
  1312  	return
  1313  }
  1314  
  1315  //sys	setupDiClassGuidsFromNameEx(className *uint16, classGuidList *GUID, classGuidListSize uint32, requiredSize *uint32, machineName *uint16, reserved uintptr) (err error) = setupapi.SetupDiClassGuidsFromNameExW
  1316  
  1317  // SetupDiClassGuidsFromNameEx function retrieves the GUIDs associated with the specified class name. This resulting list contains the classes currently installed on a local or remote computer.
  1318  func SetupDiClassGuidsFromNameEx(className string, machineName string) ([]GUID, error) {
  1319  	classNameUTF16, err := UTF16PtrFromString(className)
  1320  	if err != nil {
  1321  		return nil, err
  1322  	}
  1323  
  1324  	var machineNameUTF16 *uint16
  1325  	if machineName != "" {
  1326  		machineNameUTF16, err = UTF16PtrFromString(machineName)
  1327  		if err != nil {
  1328  			return nil, err
  1329  		}
  1330  	}
  1331  
  1332  	reqSize := uint32(4)
  1333  	for {
  1334  		buf := make([]GUID, reqSize)
  1335  		err = setupDiClassGuidsFromNameEx(classNameUTF16, &buf[0], uint32(len(buf)), &reqSize, machineNameUTF16, 0)
  1336  		if err == ERROR_INSUFFICIENT_BUFFER {
  1337  			continue
  1338  		}
  1339  		if err != nil {
  1340  			return nil, err
  1341  		}
  1342  		return buf[:reqSize], nil
  1343  	}
  1344  }
  1345  
  1346  //sys	setupDiGetSelectedDevice(deviceInfoSet DevInfo, deviceInfoData *DevInfoData) (err error) = setupapi.SetupDiGetSelectedDevice
  1347  
  1348  // SetupDiGetSelectedDevice function retrieves the selected device information element in a device information set.
  1349  func SetupDiGetSelectedDevice(deviceInfoSet DevInfo) (*DevInfoData, error) {
  1350  	data := &DevInfoData{}
  1351  	data.size = uint32(unsafe.Sizeof(*data))
  1352  
  1353  	return data, setupDiGetSelectedDevice(deviceInfoSet, data)
  1354  }
  1355  
  1356  // SelectedDevice method retrieves the selected device information element in a device information set.
  1357  func (deviceInfoSet DevInfo) SelectedDevice() (*DevInfoData, error) {
  1358  	return SetupDiGetSelectedDevice(deviceInfoSet)
  1359  }
  1360  
  1361  // SetupDiSetSelectedDevice function sets a device information element as the selected member of a device information set. This function is typically used by an installation wizard.
  1362  //sys	SetupDiSetSelectedDevice(deviceInfoSet DevInfo, deviceInfoData *DevInfoData) (err error) = setupapi.SetupDiSetSelectedDevice
  1363  
  1364  // SetSelectedDevice method sets a device information element as the selected member of a device information set. This function is typically used by an installation wizard.
  1365  func (deviceInfoSet DevInfo) SetSelectedDevice(deviceInfoData *DevInfoData) error {
  1366  	return SetupDiSetSelectedDevice(deviceInfoSet, deviceInfoData)
  1367  }
  1368  
  1369  //sys	setupUninstallOEMInf(infFileName *uint16, flags SUOI, reserved uintptr) (err error) = setupapi.SetupUninstallOEMInfW
  1370  
  1371  // SetupUninstallOEMInf uninstalls the specified driver.
  1372  func SetupUninstallOEMInf(infFileName string, flags SUOI) error {
  1373  	infFileName16, err := UTF16PtrFromString(infFileName)
  1374  	if err != nil {
  1375  		return err
  1376  	}
  1377  	return setupUninstallOEMInf(infFileName16, flags, 0)
  1378  }
  1379  
  1380  //sys cm_MapCrToWin32Err(configRet CONFIGRET, defaultWin32Error Errno) (ret Errno) = CfgMgr32.CM_MapCrToWin32Err
  1381  
  1382  //sys cm_Get_Device_Interface_List_Size(len *uint32, interfaceClass *GUID, deviceID *uint16, flags uint32) (ret CONFIGRET) = CfgMgr32.CM_Get_Device_Interface_List_SizeW
  1383  //sys cm_Get_Device_Interface_List(interfaceClass *GUID, deviceID *uint16, buffer *uint16, bufferLen uint32, flags uint32) (ret CONFIGRET) = CfgMgr32.CM_Get_Device_Interface_ListW
  1384  
  1385  func CM_Get_Device_Interface_List(deviceID string, interfaceClass *GUID, flags uint32) ([]string, error) {
  1386  	deviceID16, err := UTF16PtrFromString(deviceID)
  1387  	if err != nil {
  1388  		return nil, err
  1389  	}
  1390  	var buf []uint16
  1391  	var buflen uint32
  1392  	for {
  1393  		if ret := cm_Get_Device_Interface_List_Size(&buflen, interfaceClass, deviceID16, flags); ret != CR_SUCCESS {
  1394  			return nil, ret
  1395  		}
  1396  		buf = make([]uint16, buflen)
  1397  		if ret := cm_Get_Device_Interface_List(interfaceClass, deviceID16, &buf[0], buflen, flags); ret == CR_SUCCESS {
  1398  			break
  1399  		} else if ret != CR_BUFFER_SMALL {
  1400  			return nil, ret
  1401  		}
  1402  	}
  1403  	var interfaces []string
  1404  	for i := 0; i < len(buf); {
  1405  		j := i + wcslen(buf[i:])
  1406  		if i < j {
  1407  			interfaces = append(interfaces, UTF16ToString(buf[i:j]))
  1408  		}
  1409  		i = j + 1
  1410  	}
  1411  	if interfaces == nil {
  1412  		return nil, ERROR_NO_SUCH_DEVICE_INTERFACE
  1413  	}
  1414  	return interfaces, nil
  1415  }
  1416  
  1417  //sys cm_Get_DevNode_Status(status *uint32, problemNumber *uint32, devInst DEVINST, flags uint32) (ret CONFIGRET) = CfgMgr32.CM_Get_DevNode_Status
  1418  
  1419  func CM_Get_DevNode_Status(status *uint32, problemNumber *uint32, devInst DEVINST, flags uint32) error {
  1420  	ret := cm_Get_DevNode_Status(status, problemNumber, devInst, flags)
  1421  	if ret == CR_SUCCESS {
  1422  		return nil
  1423  	}
  1424  	return ret
  1425  }
  1426  

View as plain text