setupapi_windows.go raw
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 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