| 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 |
} |