2 * SetupAPI device installer
4 * Copyright 2000 Andreas Mohr for CodeWeavers
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
22 #include "wine/port.h"
35 #include "wine/debug.h"
36 #include "wine/list.h"
37 #include "wine/unicode.h"
44 #include "setupapi_private.h"
47 WINE_DEFAULT_DEBUG_CHANNEL(setupapi);
49 /* Unicode constants */
50 static const WCHAR ClassGUID[] = {'C','l','a','s','s','G','U','I','D',0};
51 static const WCHAR Class[] = {'C','l','a','s','s',0};
52 static const WCHAR ClassInstall32[] = {'C','l','a','s','s','I','n','s','t','a','l','l','3','2',0};
53 static const WCHAR NoDisplayClass[] = {'N','o','D','i','s','p','l','a','y','C','l','a','s','s',0};
54 static const WCHAR NoInstallClass[] = {'N','o','I','n','s','t','a','l','l','C','l','a','s','s',0};
55 static const WCHAR NoUseClass[] = {'N','o','U','s','e','C','l','a','s','s',0};
56 static const WCHAR NtExtension[] = {'.','N','T',0};
57 static const WCHAR NtPlatformExtension[] = {'.','N','T','x','8','6',0};
58 static const WCHAR Version[] = {'V','e','r','s','i','o','n',0};
59 static const WCHAR WinExtension[] = {'.','W','i','n',0};
61 /* Registry key and value names */
62 static const WCHAR ControlClass[] = {'S','y','s','t','e','m','\\',
63 'C','u','r','r','e','n','t','C','o','n','t','r','o','l','S','e','t','\\',
64 'C','o','n','t','r','o','l','\\',
65 'C','l','a','s','s',0};
67 static const WCHAR DeviceClasses[] = {'S','y','s','t','e','m','\\',
68 'C','u','r','r','e','n','t','C','o','n','t','r','o','l','S','e','t','\\',
69 'C','o','n','t','r','o','l','\\',
70 'D','e','v','i','c','e','C','l','a','s','s','e','s',0};
71 static const WCHAR Enum[] = {'S','y','s','t','e','m','\\',
72 'C','u','r','r','e','n','t','C','o','n','t','r','o','l','S','e','t','\\',
74 static const WCHAR DeviceDesc[] = {'D','e','v','i','c','e','D','e','s','c',0};
75 static const WCHAR DeviceInstance[] = {'D','e','v','i','c','e','I','n','s','t','a','n','c','e',0};
76 static const WCHAR HardwareId[] = {'H','a','r','d','w','a','r','e','I','D',0};
77 static const WCHAR CompatibleIDs[] = {'C','o','m','p','a','t','i','b','l','e','I','d','s',0};
78 static const WCHAR Service[] = {'S','e','r','v','i','c','e',0};
79 static const WCHAR Driver[] = {'D','r','i','v','e','r',0};
80 static const WCHAR ConfigFlags[] = {'C','o','n','f','i','g','F','l','a','g','s',0};
81 static const WCHAR Mfg[] = {'M','f','g',0};
82 static const WCHAR FriendlyName[] = {'F','r','i','e','n','d','l','y','N','a','m','e',0};
83 static const WCHAR LocationInformation[] = {'L','o','c','a','t','i','o','n','I','n','f','o','r','m','a','t','i','o','n',0};
84 static const WCHAR Capabilities[] = {'C','a','p','a','b','i','l','i','t','i','e','s',0};
85 static const WCHAR UINumber[] = {'U','I','N','u','m','b','e','r',0};
86 static const WCHAR UpperFilters[] = {'U','p','p','e','r','F','i','l','t','e','r','s',0};
87 static const WCHAR LowerFilters[] = {'L','o','w','e','r','F','i','l','t','e','r','s',0};
88 static const WCHAR Phantom[] = {'P','h','a','n','t','o','m',0};
89 static const WCHAR SymbolicLink[] = {'S','y','m','b','o','l','i','c','L','i','n','k',0};
91 /* is used to identify if a DeviceInfoSet pointer is
93 #define SETUP_DEVICE_INFO_SET_MAGIC 0xd00ff056
97 DWORD magic; /* if is equal to SETUP_DEVICE_INFO_SET_MAGIC struct is okay */
101 SP_DEVINFO_DATA *devices;
104 /* Pointed to by SP_DEVICE_INTERFACE_DATA's Reserved member */
107 LPWSTR referenceString;
109 PSP_DEVINFO_DATA device;
112 /* A device may have multiple instances of the same interface, so this holds
113 * each instance belonging to a particular interface.
115 struct InterfaceInstances
119 DWORD cInstancesAllocated;
120 SP_DEVICE_INTERFACE_DATA *instances;
124 /* Pointed to by SP_DEVINFO_DATA's Reserved member */
127 struct DeviceInfoSet *set;
132 struct list interfaces;
135 static void SETUPDI_GuidToString(const GUID *guid, LPWSTR guidStr)
137 static const WCHAR fmt[] = {'{','%','0','8','X','-','%','0','4','X','-',
138 '%','0','4','X','-','%','0','2','X','%','0','2','X','-','%','0','2',
139 'X','%','0','2','X','%','0','2','X','%','0','2','X','%','0','2','X','%',
142 sprintfW(guidStr, fmt, guid->Data1, guid->Data2, guid->Data3,
143 guid->Data4[0], guid->Data4[1], guid->Data4[2], guid->Data4[3],
144 guid->Data4[4], guid->Data4[5], guid->Data4[6], guid->Data4[7]);
147 static void SETUPDI_FreeInterfaceInstances(struct InterfaceInstances *instances)
151 for (i = 0; i < instances->cInstances; i++)
153 struct InterfaceInfo *ifaceInfo =
154 (struct InterfaceInfo *)instances->instances[i].Reserved;
156 if (ifaceInfo->device && ifaceInfo->device->Reserved)
158 struct DeviceInfo *devInfo =
159 (struct DeviceInfo *)ifaceInfo->device->Reserved;
161 if (devInfo->phantom)
162 SetupDiDeleteDeviceInterfaceRegKey(devInfo->set,
163 &instances->instances[i], 0);
165 HeapFree(GetProcessHeap(), 0, ifaceInfo->referenceString);
166 HeapFree(GetProcessHeap(), 0, ifaceInfo->symbolicLink);
167 HeapFree(GetProcessHeap(), 0, ifaceInfo);
169 HeapFree(GetProcessHeap(), 0, instances->instances);
172 /* Finds the interface with interface class InterfaceClassGuid in the device.
173 * Returns TRUE if found, and updates *interface to point to device's
174 * interfaces member where the given interface was found.
175 * Returns FALSE if not found.
177 static BOOL SETUPDI_FindInterface(const struct DeviceInfo *devInfo,
178 const GUID *InterfaceClassGuid, struct InterfaceInstances **interface)
181 struct InterfaceInstances *iface;
183 TRACE("%s\n", debugstr_guid(InterfaceClassGuid));
185 LIST_FOR_EACH_ENTRY(iface, &devInfo->interfaces, struct InterfaceInstances,
188 if (IsEqualGUID(&iface->guid, InterfaceClassGuid))
195 TRACE("returning %d (%p)\n", found, found ? *interface : NULL);
199 /* Finds the interface instance with reference string ReferenceString in the
200 * interface instance map. Returns TRUE if found, and updates instanceIndex to
201 * the index of the interface instance's instances member
202 * where the given instance was found. Returns FALSE if not found.
204 static BOOL SETUPDI_FindInterfaceInstance(
205 const struct InterfaceInstances *instances,
206 LPCWSTR ReferenceString, DWORD *instanceIndex)
211 TRACE("%s\n", debugstr_w(ReferenceString));
213 for (i = 0; !found && i < instances->cInstances; i++)
215 SP_DEVICE_INTERFACE_DATA *ifaceData = &instances->instances[i];
216 struct InterfaceInfo *ifaceInfo =
217 (struct InterfaceInfo *)ifaceData->Reserved;
219 if (!ReferenceString && !ifaceInfo->referenceString)
224 else if (ReferenceString && ifaceInfo->referenceString &&
225 !lstrcmpiW(ifaceInfo->referenceString, ReferenceString))
231 TRACE("returning %d (%d)\n", found, found ? *instanceIndex : 0);
235 static LPWSTR SETUPDI_CreateSymbolicLinkPath(LPCWSTR instanceId,
236 const GUID *InterfaceClassGuid, LPCWSTR ReferenceString)
238 static const WCHAR fmt[] = {'\\','\\','?','\\','%','s','#','%','s',0};
243 SETUPDI_GuidToString(InterfaceClassGuid, guidStr);
244 /* omit length of format specifiers, but include NULL terminator: */
245 len = lstrlenW(fmt) - 4 + 1;
246 len += lstrlenW(instanceId) + lstrlenW(guidStr);
249 /* space for a hash between string and reference string: */
250 len += lstrlenW(ReferenceString) + 1;
252 ret = HeapAlloc(GetProcessHeap(), 0, len * sizeof(WCHAR));
255 int printed = sprintfW(ret, fmt, instanceId, guidStr);
258 /* replace '\\' with '#' after the "\\\\?\\" beginning */
259 for (ptr = strchrW(ret + 4, '\\'); ptr; ptr = strchrW(ptr + 1, '\\'))
263 ret[printed - 1] = '\\';
264 lstrcpyW(ret + printed, ReferenceString);
270 /* Adds an interface with the given interface class and reference string to
271 * the device, if it doesn't already exist in the device. If iface is not
272 * NULL, returns a pointer to the newly added (or already existing) interface.
274 static BOOL SETUPDI_AddInterfaceInstance(PSP_DEVINFO_DATA DeviceInfoData,
275 const GUID *InterfaceClassGuid, LPCWSTR ReferenceString,
276 SP_DEVICE_INTERFACE_DATA **ifaceData)
278 struct DeviceInfo *devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
279 BOOL newInterface = FALSE, ret;
280 struct InterfaceInstances *iface = NULL;
282 TRACE("%p %s %s %p\n", devInfo, debugstr_guid(InterfaceClassGuid),
283 debugstr_w(ReferenceString), iface);
285 if (!(ret = SETUPDI_FindInterface(devInfo, InterfaceClassGuid, &iface)))
287 iface = HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY,
288 sizeof(struct InterfaceInstances));
291 list_add_tail(&devInfo->interfaces, &iface->entry);
297 DWORD instanceIndex = 0;
299 if (!(ret = SETUPDI_FindInterfaceInstance(iface, ReferenceString,
302 SP_DEVICE_INTERFACE_DATA *instance = NULL;
304 if (!iface->cInstancesAllocated)
306 iface->instances = HeapAlloc(GetProcessHeap(), 0,
307 sizeof(SP_DEVICE_INTERFACE_DATA));
308 if (iface->instances)
309 instance = &iface->instances[iface->cInstancesAllocated++];
311 else if (iface->cInstances == iface->cInstancesAllocated)
313 iface->instances = HeapReAlloc(GetProcessHeap(), 0,
315 (iface->cInstancesAllocated + 1) *
316 sizeof(SP_DEVICE_INTERFACE_DATA));
317 if (iface->instances)
318 instance = &iface->instances[iface->cInstancesAllocated++];
321 instance = &iface->instances[iface->cInstances];
324 struct InterfaceInfo *ifaceInfo = HeapAlloc(GetProcessHeap(),
325 0, sizeof(struct InterfaceInfo));
330 ifaceInfo->device = DeviceInfoData;
331 ifaceInfo->symbolicLink = SETUPDI_CreateSymbolicLinkPath(
332 devInfo->instanceId, InterfaceClassGuid,
336 ifaceInfo->referenceString =
337 HeapAlloc(GetProcessHeap(), 0,
338 (lstrlenW(ReferenceString) + 1) *
340 if (ifaceInfo->referenceString)
341 lstrcpyW(ifaceInfo->referenceString,
347 ifaceInfo->referenceString = NULL;
354 sizeof(SP_DEVICE_INTERFACE_DATA);
355 instance->InterfaceClassGuid = *InterfaceClassGuid;
356 instance->Flags = SPINT_ACTIVE; /* FIXME */
357 instance->Reserved = (ULONG_PTR)ifaceInfo;
359 iface->guid = *InterfaceClassGuid;
360 key = SetupDiCreateDeviceInterfaceRegKeyW(devInfo->set,
361 instance, 0, KEY_WRITE, NULL, NULL);
362 if (key != INVALID_HANDLE_VALUE)
364 RegSetValueExW(key, SymbolicLink, 0, REG_SZ,
365 (BYTE *)ifaceInfo->symbolicLink,
366 lstrlenW(ifaceInfo->symbolicLink) *
371 *ifaceData = instance;
374 HeapFree(GetProcessHeap(), 0, ifaceInfo);
381 *ifaceData = &iface->instances[instanceIndex];
386 TRACE("returning %d\n", ret);
390 static BOOL SETUPDI_SetInterfaceSymbolicLink(SP_DEVICE_INTERFACE_DATA *iface,
391 LPCWSTR symbolicLink)
393 struct InterfaceInfo *info = (struct InterfaceInfo *)iface->Reserved;
398 HeapFree(GetProcessHeap(), 0, info->symbolicLink);
399 info->symbolicLink = HeapAlloc(GetProcessHeap(), 0,
400 (lstrlenW(symbolicLink) + 1) * sizeof(WCHAR));
401 if (info->symbolicLink)
403 lstrcpyW(info->symbolicLink, symbolicLink);
410 static HKEY SETUPDI_CreateDevKey(struct DeviceInfo *devInfo)
412 HKEY enumKey, key = INVALID_HANDLE_VALUE;
415 l = RegCreateKeyExW(HKEY_LOCAL_MACHINE, Enum, 0, NULL, 0, KEY_ALL_ACCESS,
416 NULL, &enumKey, NULL);
419 RegCreateKeyExW(enumKey, devInfo->instanceId, 0, NULL, 0,
420 KEY_READ | KEY_WRITE, NULL, &key, NULL);
421 RegCloseKey(enumKey);
426 static HKEY SETUPDI_CreateDrvKey(struct DeviceInfo *devInfo)
428 static const WCHAR slash[] = { '\\',0 };
429 WCHAR classKeyPath[MAX_PATH];
430 HKEY classKey, key = INVALID_HANDLE_VALUE;
433 lstrcpyW(classKeyPath, ControlClass);
434 lstrcatW(classKeyPath, slash);
435 SETUPDI_GuidToString(&devInfo->set->ClassGuid,
436 classKeyPath + lstrlenW(classKeyPath));
437 l = RegCreateKeyExW(HKEY_LOCAL_MACHINE, classKeyPath, 0, NULL, 0,
438 KEY_ALL_ACCESS, NULL, &classKey, NULL);
441 static const WCHAR fmt[] = { '%','0','4','u',0 };
444 sprintfW(devId, fmt, devInfo->devId);
445 RegCreateKeyExW(classKey, devId, 0, NULL, 0, KEY_READ | KEY_WRITE,
447 RegCloseKey(classKey);
452 static struct DeviceInfo *SETUPDI_AllocateDeviceInfo(struct DeviceInfoSet *set,
453 DWORD devId, LPCWSTR instanceId, BOOL phantom)
455 struct DeviceInfo *devInfo = NULL;
456 HANDLE devInst = GlobalAlloc(GMEM_FIXED, sizeof(struct DeviceInfo));
458 devInfo = GlobalLock(devInst);
463 devInfo->devId = (DWORD)devInst;
465 devInfo->instanceId = HeapAlloc(GetProcessHeap(), 0,
466 (lstrlenW(instanceId) + 1) * sizeof(WCHAR));
467 if (devInfo->instanceId)
469 devInfo->key = INVALID_HANDLE_VALUE;
470 devInfo->phantom = phantom;
471 lstrcpyW(devInfo->instanceId, instanceId);
472 struprW(devInfo->instanceId);
473 devInfo->key = SETUPDI_CreateDevKey(devInfo);
474 if (devInfo->key != INVALID_HANDLE_VALUE)
477 RegSetValueExW(devInfo->key, Phantom, 0, REG_DWORD,
478 (LPBYTE)&phantom, sizeof(phantom));
480 list_init(&devInfo->interfaces);
481 GlobalUnlock(devInst);
485 GlobalUnlock(devInst);
493 static void SETUPDI_FreeDeviceInfo(struct DeviceInfo *devInfo)
495 struct InterfaceInstances *iface, *next;
497 if (devInfo->key != INVALID_HANDLE_VALUE)
498 RegCloseKey(devInfo->key);
499 if (devInfo->phantom)
504 l = RegCreateKeyExW(HKEY_LOCAL_MACHINE, Enum, 0, NULL, 0,
505 KEY_ALL_ACCESS, NULL, &enumKey, NULL);
508 RegDeleteTreeW(enumKey, devInfo->instanceId);
509 RegCloseKey(enumKey);
512 HeapFree(GetProcessHeap(), 0, devInfo->instanceId);
513 LIST_FOR_EACH_ENTRY_SAFE(iface, next, &devInfo->interfaces,
514 struct InterfaceInstances, entry)
516 list_remove(&iface->entry);
517 SETUPDI_FreeInterfaceInstances(iface);
518 HeapFree(GetProcessHeap(), 0, iface);
520 GlobalFree((HANDLE)devInfo->devId);
523 /* Adds a device with GUID guid and identifer devInst to set. Allocates a
524 * struct DeviceInfo, and points the returned device info's Reserved member
525 * to it. "Phantom" devices are deleted from the registry when closed.
526 * Returns a pointer to the newly allocated device info.
528 static BOOL SETUPDI_AddDeviceToSet(struct DeviceInfoSet *set,
533 SP_DEVINFO_DATA **dev)
536 struct DeviceInfo *devInfo = SETUPDI_AllocateDeviceInfo(set, set->cDevices,
537 instanceId, phantom);
539 TRACE("%p, %s, %d, %s, %d\n", set, debugstr_guid(guid), devInst,
540 debugstr_w(instanceId), phantom);
545 set->devices = HeapReAlloc(GetProcessHeap(), 0, set->devices,
546 (set->cDevices + 1) * sizeof(SP_DEVINFO_DATA));
548 set->devices = HeapAlloc(GetProcessHeap(), 0,
549 sizeof(SP_DEVINFO_DATA));
552 WCHAR classGuidStr[39];
553 SP_DEVINFO_DATA *DeviceInfoData = &set->devices[set->cDevices++];
555 DeviceInfoData->cbSize = sizeof(SP_DEVINFO_DATA);
556 DeviceInfoData->ClassGuid = *guid;
557 DeviceInfoData->DevInst = devInfo->devId;
558 DeviceInfoData->Reserved = (ULONG_PTR)devInfo;
559 SETUPDI_GuidToString(guid, classGuidStr);
560 SetupDiSetDeviceRegistryPropertyW((HDEVINFO)set,
561 DeviceInfoData, SPDRP_CLASSGUID, (const BYTE *)classGuidStr,
562 lstrlenW(classGuidStr) * sizeof(WCHAR));
564 *dev = DeviceInfoData;
569 HeapFree(GetProcessHeap(), 0, devInfo);
570 SetLastError(ERROR_OUTOFMEMORY);
576 /***********************************************************************
577 * SetupDiBuildClassInfoList (SETUPAPI.@)
579 * Returns a list of setup class GUIDs that identify the classes
580 * that are installed on a local machine.
583 * Flags [I] control exclusion of classes from the list.
584 * ClassGuidList [O] pointer to a GUID-typed array that receives a list of setup class GUIDs.
585 * ClassGuidListSize [I] The number of GUIDs in the array (ClassGuidList).
586 * RequiredSize [O] pointer, which receives the number of GUIDs that are returned.
592 BOOL WINAPI SetupDiBuildClassInfoList(
594 LPGUID ClassGuidList,
595 DWORD ClassGuidListSize,
599 return SetupDiBuildClassInfoListExW(Flags, ClassGuidList,
600 ClassGuidListSize, RequiredSize,
604 /***********************************************************************
605 * SetupDiBuildClassInfoListExA (SETUPAPI.@)
607 * Returns a list of setup class GUIDs that identify the classes
608 * that are installed on a local or remote macine.
611 * Flags [I] control exclusion of classes from the list.
612 * ClassGuidList [O] pointer to a GUID-typed array that receives a list of setup class GUIDs.
613 * ClassGuidListSize [I] The number of GUIDs in the array (ClassGuidList).
614 * RequiredSize [O] pointer, which receives the number of GUIDs that are returned.
615 * MachineName [I] name of a remote machine.
616 * Reserved [I] must be NULL.
622 BOOL WINAPI SetupDiBuildClassInfoListExA(
624 LPGUID ClassGuidList,
625 DWORD ClassGuidListSize,
630 LPWSTR MachineNameW = NULL;
637 MachineNameW = MultiByteToUnicode(MachineName, CP_ACP);
638 if (MachineNameW == NULL) return FALSE;
641 bResult = SetupDiBuildClassInfoListExW(Flags, ClassGuidList,
642 ClassGuidListSize, RequiredSize,
643 MachineNameW, Reserved);
645 MyFree(MachineNameW);
650 /***********************************************************************
651 * SetupDiBuildClassInfoListExW (SETUPAPI.@)
653 * Returns a list of setup class GUIDs that identify the classes
654 * that are installed on a local or remote macine.
657 * Flags [I] control exclusion of classes from the list.
658 * ClassGuidList [O] pointer to a GUID-typed array that receives a list of setup class GUIDs.
659 * ClassGuidListSize [I] The number of GUIDs in the array (ClassGuidList).
660 * RequiredSize [O] pointer, which receives the number of GUIDs that are returned.
661 * MachineName [I] name of a remote machine.
662 * Reserved [I] must be NULL.
668 BOOL WINAPI SetupDiBuildClassInfoListExW(
670 LPGUID ClassGuidList,
671 DWORD ClassGuidListSize,
682 DWORD dwGuidListIndex = 0;
686 if (RequiredSize != NULL)
689 hClassesKey = SetupDiOpenClassRegKeyExW(NULL,
694 if (hClassesKey == INVALID_HANDLE_VALUE)
699 for (dwIndex = 0; ; dwIndex++)
702 lError = RegEnumKeyExW(hClassesKey,
710 TRACE("RegEnumKeyExW() returns %d\n", lError);
711 if (lError == ERROR_SUCCESS || lError == ERROR_MORE_DATA)
713 TRACE("Key name: %p\n", szKeyName);
715 if (RegOpenKeyExW(hClassesKey,
721 RegCloseKey(hClassesKey);
725 if (!RegQueryValueExW(hClassKey,
732 TRACE("'NoUseClass' value found!\n");
733 RegCloseKey(hClassKey);
737 if ((Flags & DIBCI_NOINSTALLCLASS) &&
738 (!RegQueryValueExW(hClassKey,
745 TRACE("'NoInstallClass' value found!\n");
746 RegCloseKey(hClassKey);
750 if ((Flags & DIBCI_NODISPLAYCLASS) &&
751 (!RegQueryValueExW(hClassKey,
758 TRACE("'NoDisplayClass' value found!\n");
759 RegCloseKey(hClassKey);
763 RegCloseKey(hClassKey);
765 TRACE("Guid: %p\n", szKeyName);
766 if (dwGuidListIndex < ClassGuidListSize)
768 if (szKeyName[0] == '{' && szKeyName[37] == '}')
772 TRACE("Guid: %p\n", &szKeyName[1]);
774 UuidFromStringW(&szKeyName[1],
775 &ClassGuidList[dwGuidListIndex]);
781 if (lError != ERROR_SUCCESS)
785 RegCloseKey(hClassesKey);
787 if (RequiredSize != NULL)
788 *RequiredSize = dwGuidListIndex;
790 if (ClassGuidListSize < dwGuidListIndex)
792 SetLastError(ERROR_INSUFFICIENT_BUFFER);
799 /***********************************************************************
800 * SetupDiClassGuidsFromNameA (SETUPAPI.@)
802 BOOL WINAPI SetupDiClassGuidsFromNameA(
804 LPGUID ClassGuidList,
805 DWORD ClassGuidListSize,
808 return SetupDiClassGuidsFromNameExA(ClassName, ClassGuidList,
809 ClassGuidListSize, RequiredSize,
813 /***********************************************************************
814 * SetupDiClassGuidsFromNameW (SETUPAPI.@)
816 BOOL WINAPI SetupDiClassGuidsFromNameW(
818 LPGUID ClassGuidList,
819 DWORD ClassGuidListSize,
822 return SetupDiClassGuidsFromNameExW(ClassName, ClassGuidList,
823 ClassGuidListSize, RequiredSize,
827 /***********************************************************************
828 * SetupDiClassGuidsFromNameExA (SETUPAPI.@)
830 BOOL WINAPI SetupDiClassGuidsFromNameExA(
832 LPGUID ClassGuidList,
833 DWORD ClassGuidListSize,
838 LPWSTR ClassNameW = NULL;
839 LPWSTR MachineNameW = NULL;
842 ClassNameW = MultiByteToUnicode(ClassName, CP_ACP);
843 if (ClassNameW == NULL)
848 MachineNameW = MultiByteToUnicode(MachineName, CP_ACP);
849 if (MachineNameW == NULL)
856 bResult = SetupDiClassGuidsFromNameExW(ClassNameW, ClassGuidList,
857 ClassGuidListSize, RequiredSize,
858 MachineNameW, Reserved);
860 MyFree(MachineNameW);
866 /***********************************************************************
867 * SetupDiClassGuidsFromNameExW (SETUPAPI.@)
869 BOOL WINAPI SetupDiClassGuidsFromNameExW(
871 LPGUID ClassGuidList,
872 DWORD ClassGuidListSize,
878 WCHAR szClassName[256];
884 DWORD dwGuidListIndex = 0;
886 if (RequiredSize != NULL)
889 hClassesKey = SetupDiOpenClassRegKeyExW(NULL,
894 if (hClassesKey == INVALID_HANDLE_VALUE)
899 for (dwIndex = 0; ; dwIndex++)
902 lError = RegEnumKeyExW(hClassesKey,
910 TRACE("RegEnumKeyExW() returns %d\n", lError);
911 if (lError == ERROR_SUCCESS || lError == ERROR_MORE_DATA)
913 TRACE("Key name: %p\n", szKeyName);
915 if (RegOpenKeyExW(hClassesKey,
921 RegCloseKey(hClassesKey);
925 dwLength = 256 * sizeof(WCHAR);
926 if (!RegQueryValueExW(hClassKey,
933 TRACE("Class name: %p\n", szClassName);
935 if (strcmpiW(szClassName, ClassName) == 0)
937 TRACE("Found matching class name\n");
939 TRACE("Guid: %p\n", szKeyName);
940 if (dwGuidListIndex < ClassGuidListSize)
942 if (szKeyName[0] == '{' && szKeyName[37] == '}')
946 TRACE("Guid: %p\n", &szKeyName[1]);
948 UuidFromStringW(&szKeyName[1],
949 &ClassGuidList[dwGuidListIndex]);
956 RegCloseKey(hClassKey);
959 if (lError != ERROR_SUCCESS)
963 RegCloseKey(hClassesKey);
965 if (RequiredSize != NULL)
966 *RequiredSize = dwGuidListIndex;
968 if (ClassGuidListSize < dwGuidListIndex)
970 SetLastError(ERROR_INSUFFICIENT_BUFFER);
977 /***********************************************************************
978 * SetupDiClassNameFromGuidA (SETUPAPI.@)
980 BOOL WINAPI SetupDiClassNameFromGuidA(
981 const GUID* ClassGuid,
986 return SetupDiClassNameFromGuidExA(ClassGuid, ClassName,
987 ClassNameSize, RequiredSize,
991 /***********************************************************************
992 * SetupDiClassNameFromGuidW (SETUPAPI.@)
994 BOOL WINAPI SetupDiClassNameFromGuidW(
995 const GUID* ClassGuid,
1000 return SetupDiClassNameFromGuidExW(ClassGuid, ClassName,
1001 ClassNameSize, RequiredSize,
1005 /***********************************************************************
1006 * SetupDiClassNameFromGuidExA (SETUPAPI.@)
1008 BOOL WINAPI SetupDiClassNameFromGuidExA(
1009 const GUID* ClassGuid,
1011 DWORD ClassNameSize,
1012 PDWORD RequiredSize,
1016 WCHAR ClassNameW[MAX_CLASS_NAME_LEN];
1017 LPWSTR MachineNameW = NULL;
1021 MachineNameW = MultiByteToUnicode(MachineName, CP_ACP);
1022 ret = SetupDiClassNameFromGuidExW(ClassGuid, ClassNameW, MAX_CLASS_NAME_LEN,
1023 NULL, MachineNameW, Reserved);
1026 int len = WideCharToMultiByte(CP_ACP, 0, ClassNameW, -1, ClassName,
1027 ClassNameSize, NULL, NULL);
1029 if (!ClassNameSize && RequiredSize)
1030 *RequiredSize = len;
1032 MyFree(MachineNameW);
1036 /***********************************************************************
1037 * SetupDiClassNameFromGuidExW (SETUPAPI.@)
1039 BOOL WINAPI SetupDiClassNameFromGuidExW(
1040 const GUID* ClassGuid,
1042 DWORD ClassNameSize,
1043 PDWORD RequiredSize,
1050 hKey = SetupDiOpenClassRegKeyExW(ClassGuid,
1055 if (hKey == INVALID_HANDLE_VALUE)
1060 if (RequiredSize != NULL)
1063 if (RegQueryValueExW(hKey,
1074 *RequiredSize = dwLength / sizeof(WCHAR);
1077 dwLength = ClassNameSize * sizeof(WCHAR);
1078 if (RegQueryValueExW(hKey,
1094 /***********************************************************************
1095 * SetupDiCreateDeviceInfoList (SETUPAPI.@)
1098 SetupDiCreateDeviceInfoList(const GUID *ClassGuid,
1101 return SetupDiCreateDeviceInfoListExW(ClassGuid, hwndParent, NULL, NULL);
1104 /***********************************************************************
1105 * SetupDiCreateDeviceInfoListExA (SETUPAPI.@)
1108 SetupDiCreateDeviceInfoListExA(const GUID *ClassGuid,
1113 LPWSTR MachineNameW = NULL;
1120 MachineNameW = MultiByteToUnicode(MachineName, CP_ACP);
1121 if (MachineNameW == NULL)
1122 return INVALID_HANDLE_VALUE;
1125 hDevInfo = SetupDiCreateDeviceInfoListExW(ClassGuid, hwndParent,
1126 MachineNameW, Reserved);
1128 MyFree(MachineNameW);
1133 /***********************************************************************
1134 * SetupDiCreateDeviceInfoListExW (SETUPAPI.@)
1136 * Create an empty DeviceInfoSet list.
1139 * ClassGuid [I] if not NULL only devices with GUID ClcassGuid are associated
1141 * hwndParent [I] hwnd needed for interface related actions.
1142 * MachineName [I] name of machine to create emtpy DeviceInfoSet list, if NULL
1143 * local registry will be used.
1144 * Reserved [I] must be NULL
1147 * Success: empty list.
1148 * Failure: INVALID_HANDLE_VALUE.
1151 SetupDiCreateDeviceInfoListExW(const GUID *ClassGuid,
1156 struct DeviceInfoSet *list = NULL;
1157 DWORD size = sizeof(struct DeviceInfoSet);
1159 TRACE("%s %p %s %p\n", debugstr_guid(ClassGuid), hwndParent,
1160 debugstr_w(MachineName), Reserved);
1162 if (MachineName != NULL)
1164 FIXME("remote support is not implemented\n");
1165 SetLastError(ERROR_INVALID_MACHINENAME);
1166 return INVALID_HANDLE_VALUE;
1169 if (Reserved != NULL)
1171 SetLastError(ERROR_INVALID_PARAMETER);
1172 return INVALID_HANDLE_VALUE;
1175 list = HeapAlloc(GetProcessHeap(), 0, size);
1178 SetLastError(ERROR_NOT_ENOUGH_MEMORY);
1179 return INVALID_HANDLE_VALUE;
1182 list->magic = SETUP_DEVICE_INFO_SET_MAGIC;
1183 list->hwndParent = hwndParent;
1184 memcpy(&list->ClassGuid,
1185 ClassGuid ? ClassGuid : &GUID_NULL,
1186 sizeof(list->ClassGuid));
1188 list->devices = NULL;
1190 return (HDEVINFO)list;
1193 /***********************************************************************
1194 * SetupDiCreateDevRegKeyA (SETUPAPI.@)
1196 HKEY WINAPI SetupDiCreateDevRegKeyA(
1197 HDEVINFO DeviceInfoSet,
1198 PSP_DEVINFO_DATA DeviceInfoData,
1203 PCSTR InfSectionName)
1205 PWSTR InfSectionNameW = NULL;
1208 TRACE("%p %p %d %d %d %p %s\n", DeviceInfoSet, DeviceInfoData, Scope,
1209 HwProfile, KeyType, InfHandle, debugstr_a(InfSectionName));
1213 if (!InfSectionName)
1215 SetLastError(ERROR_INVALID_PARAMETER);
1216 return INVALID_HANDLE_VALUE;
1220 InfSectionNameW = MultiByteToUnicode(InfSectionName, CP_ACP);
1221 if (InfSectionNameW == NULL) return INVALID_HANDLE_VALUE;
1224 key = SetupDiCreateDevRegKeyW(DeviceInfoSet, DeviceInfoData, Scope,
1225 HwProfile, KeyType, InfHandle, InfSectionNameW);
1226 MyFree(InfSectionNameW);
1230 /***********************************************************************
1231 * SetupDiCreateDevRegKeyW (SETUPAPI.@)
1233 HKEY WINAPI SetupDiCreateDevRegKeyW(
1234 HDEVINFO DeviceInfoSet,
1235 PSP_DEVINFO_DATA DeviceInfoData,
1240 PCWSTR InfSectionName)
1242 struct DeviceInfoSet *set = (struct DeviceInfoSet *)DeviceInfoSet;
1243 struct DeviceInfo *devInfo;
1244 HKEY key = INVALID_HANDLE_VALUE;
1246 TRACE("%p %p %d %d %d %p %s\n", DeviceInfoSet, DeviceInfoData, Scope,
1247 HwProfile, KeyType, InfHandle, debugstr_w(InfSectionName));
1249 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
1251 SetLastError(ERROR_INVALID_HANDLE);
1252 return INVALID_HANDLE_VALUE;
1254 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
1256 SetLastError(ERROR_INVALID_HANDLE);
1257 return INVALID_HANDLE_VALUE;
1259 if (!DeviceInfoData || DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA)
1260 || !DeviceInfoData->Reserved)
1262 SetLastError(ERROR_INVALID_PARAMETER);
1263 return INVALID_HANDLE_VALUE;
1265 devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
1266 if (devInfo->set != set)
1268 SetLastError(ERROR_INVALID_PARAMETER);
1269 return INVALID_HANDLE_VALUE;
1271 if (Scope != DICS_FLAG_GLOBAL && Scope != DICS_FLAG_CONFIGSPECIFIC)
1273 SetLastError(ERROR_INVALID_FLAGS);
1274 return INVALID_HANDLE_VALUE;
1276 if (KeyType != DIREG_DEV && KeyType != DIREG_DRV)
1278 SetLastError(ERROR_INVALID_FLAGS);
1279 return INVALID_HANDLE_VALUE;
1281 if (devInfo->phantom)
1283 SetLastError(ERROR_DEVINFO_NOT_REGISTERED);
1284 return INVALID_HANDLE_VALUE;
1286 if (Scope != DICS_FLAG_GLOBAL)
1287 FIXME("unimplemented for scope %d\n", Scope);
1291 key = SETUPDI_CreateDevKey(devInfo);
1294 key = SETUPDI_CreateDrvKey(devInfo);
1297 WARN("unknown KeyType %d\n", KeyType);
1300 SetupInstallFromInfSectionW(NULL, InfHandle, InfSectionName, SPINST_ALL,
1301 NULL, NULL, SP_COPY_NEWER_ONLY, NULL, NULL, DeviceInfoSet,
1306 /***********************************************************************
1307 * SetupDiCreateDeviceInfoA (SETUPAPI.@)
1309 BOOL WINAPI SetupDiCreateDeviceInfoA(
1310 HDEVINFO DeviceInfoSet,
1312 CONST GUID *ClassGuid,
1313 PCSTR DeviceDescription,
1315 DWORD CreationFlags,
1316 PSP_DEVINFO_DATA DeviceInfoData)
1319 LPWSTR DeviceNameW = NULL;
1320 LPWSTR DeviceDescriptionW = NULL;
1324 DeviceNameW = MultiByteToUnicode(DeviceName, CP_ACP);
1325 if (DeviceNameW == NULL) return FALSE;
1327 if (DeviceDescription)
1329 DeviceDescriptionW = MultiByteToUnicode(DeviceDescription, CP_ACP);
1330 if (DeviceDescriptionW == NULL)
1332 MyFree(DeviceNameW);
1337 ret = SetupDiCreateDeviceInfoW(DeviceInfoSet, DeviceNameW, ClassGuid, DeviceDescriptionW,
1338 hwndParent, CreationFlags, DeviceInfoData);
1340 MyFree(DeviceNameW);
1341 MyFree(DeviceDescriptionW);
1346 static DWORD SETUPDI_DevNameToDevID(LPCWSTR devName)
1349 DWORD devNameLen = lstrlenW(devName), devInst = 0;
1352 TRACE("%s\n", debugstr_w(devName));
1353 for (ptr = devName; valid && *ptr && ptr - devName < devNameLen; )
1358 devInst |= *ptr - '0';
1364 TRACE("%d\n", valid ? devInst : 0xffffffff);
1365 return valid ? devInst : 0xffffffff;
1368 /***********************************************************************
1369 * SetupDiCreateDeviceInfoW (SETUPAPI.@)
1371 BOOL WINAPI SetupDiCreateDeviceInfoW(
1372 HDEVINFO DeviceInfoSet,
1374 CONST GUID *ClassGuid,
1375 PCWSTR DeviceDescription,
1377 DWORD CreationFlags,
1378 PSP_DEVINFO_DATA DeviceInfoData)
1380 struct DeviceInfoSet *set = (struct DeviceInfoSet *)DeviceInfoSet;
1381 BOOL ret = FALSE, allocatedInstanceId = FALSE;
1382 LPCWSTR instanceId = NULL;
1384 TRACE("%p %s %s %s %p %x %p\n", DeviceInfoSet, debugstr_w(DeviceName),
1385 debugstr_guid(ClassGuid), debugstr_w(DeviceDescription),
1386 hwndParent, CreationFlags, DeviceInfoData);
1390 SetLastError(ERROR_INVALID_DEVINST_NAME);
1393 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
1395 SetLastError(ERROR_INVALID_HANDLE);
1400 SetLastError(ERROR_INVALID_PARAMETER);
1403 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
1405 SetLastError(ERROR_INVALID_HANDLE);
1408 if (!IsEqualGUID(&set->ClassGuid, &GUID_NULL) &&
1409 !IsEqualGUID(ClassGuid, &set->ClassGuid))
1411 SetLastError(ERROR_CLASS_MISMATCH);
1414 if ((CreationFlags & DICD_GENERATE_ID))
1416 if (strchrW(DeviceName, '\\'))
1417 SetLastError(ERROR_INVALID_DEVINST_NAME);
1420 static const WCHAR newDeviceFmt[] = {'R','O','O','T','\\','%','s',
1421 '\\','%','0','4','d',0};
1426 DWORD i, highestDevID = 0;
1428 for (i = 0; i < set->cDevices; i++)
1430 struct DeviceInfo *devInfo =
1431 (struct DeviceInfo *)set->devices[i].Reserved;
1432 LPCWSTR devName = strrchrW(devInfo->instanceId, '\\');
1438 devName = devInfo->instanceId;
1439 id = SETUPDI_DevNameToDevID(devName);
1440 if (id != 0xffffffff && id > highestDevID)
1443 devId = highestDevID + 1;
1447 /* 17 == lstrlenW(L"Root\\") + lstrlenW("\\") + 1 + %d max size */
1448 instanceId = HeapAlloc(GetProcessHeap(), 0,
1449 (17 + lstrlenW(DeviceName)) * sizeof(WCHAR));
1452 sprintfW((LPWSTR)instanceId, newDeviceFmt, DeviceName,
1454 allocatedInstanceId = TRUE;
1466 instanceId = DeviceName;
1467 for (i = 0; ret && i < set->cDevices; i++)
1469 struct DeviceInfo *devInfo =
1470 (struct DeviceInfo *)set->devices[i].Reserved;
1472 if (!lstrcmpiW(DeviceName, devInfo->instanceId))
1474 SetLastError(ERROR_DEVINST_ALREADY_EXISTS);
1481 SP_DEVINFO_DATA *dev = NULL;
1483 ret = SETUPDI_AddDeviceToSet(set, ClassGuid, 0 /* FIXME: DevInst */,
1484 instanceId, TRUE, &dev);
1487 if (DeviceDescription)
1488 SetupDiSetDeviceRegistryPropertyW(DeviceInfoSet,
1489 dev, SPDRP_DEVICEDESC, (const BYTE *)DeviceDescription,
1490 lstrlenW(DeviceDescription) * sizeof(WCHAR));
1493 if (DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA))
1495 SetLastError(ERROR_INVALID_USER_BUFFER);
1499 *DeviceInfoData = *dev;
1503 if (allocatedInstanceId)
1504 HeapFree(GetProcessHeap(), 0, (LPWSTR)instanceId);
1509 /***********************************************************************
1510 * SetupDiRegisterDeviceInfo (SETUPAPI.@)
1512 BOOL WINAPI SetupDiRegisterDeviceInfo(
1513 HDEVINFO DeviceInfoSet,
1514 PSP_DEVINFO_DATA DeviceInfoData,
1516 PSP_DETSIG_CMPPROC CompareProc,
1517 PVOID CompareContext,
1518 PSP_DEVINFO_DATA DupDeviceInfoData)
1520 struct DeviceInfoSet *set = (struct DeviceInfoSet *)DeviceInfoSet;
1521 struct DeviceInfo *devInfo;
1523 TRACE("%p %p %08x %p %p %p\n", DeviceInfoSet, DeviceInfoData, Flags,
1524 CompareProc, CompareContext, DupDeviceInfoData);
1526 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
1528 SetLastError(ERROR_INVALID_HANDLE);
1531 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
1533 SetLastError(ERROR_INVALID_HANDLE);
1536 if (!DeviceInfoData || DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA)
1537 || !DeviceInfoData->Reserved)
1539 SetLastError(ERROR_INVALID_PARAMETER);
1542 devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
1543 if (devInfo->set != set)
1545 SetLastError(ERROR_INVALID_PARAMETER);
1548 if (devInfo->phantom)
1550 devInfo->phantom = FALSE;
1551 RegDeleteValueW(devInfo->key, Phantom);
1556 /***********************************************************************
1557 * SetupDiEnumDeviceInfo (SETUPAPI.@)
1559 BOOL WINAPI SetupDiEnumDeviceInfo(
1562 PSP_DEVINFO_DATA info)
1566 TRACE("%p %d %p\n", devinfo, index, info);
1570 SetLastError(ERROR_INVALID_PARAMETER);
1573 if (devinfo && devinfo != INVALID_HANDLE_VALUE)
1575 struct DeviceInfoSet *list = (struct DeviceInfoSet *)devinfo;
1576 if (list->magic == SETUP_DEVICE_INFO_SET_MAGIC)
1578 if (index < list->cDevices)
1580 if (info->cbSize == sizeof(SP_DEVINFO_DATA))
1582 memcpy(info, &list->devices[index], info->cbSize);
1586 SetLastError(ERROR_INVALID_USER_BUFFER);
1589 SetLastError(ERROR_NO_MORE_ITEMS);
1592 SetLastError(ERROR_INVALID_HANDLE);
1595 SetLastError(ERROR_INVALID_HANDLE);
1599 /***********************************************************************
1600 * SetupDiGetDeviceInstanceIdA (SETUPAPI.@)
1602 BOOL WINAPI SetupDiGetDeviceInstanceIdA(
1603 HDEVINFO DeviceInfoSet,
1604 PSP_DEVINFO_DATA DeviceInfoData,
1605 PSTR DeviceInstanceId,
1606 DWORD DeviceInstanceIdSize,
1607 PDWORD RequiredSize)
1613 TRACE("%p %p %p %d %p\n", DeviceInfoSet, DeviceInfoData, DeviceInstanceId,
1614 DeviceInstanceIdSize, RequiredSize);
1616 SetupDiGetDeviceInstanceIdW(DeviceInfoSet,
1621 if (GetLastError() != ERROR_INSUFFICIENT_BUFFER)
1623 instanceId = HeapAlloc(GetProcessHeap(), 0, size * sizeof(WCHAR));
1626 ret = SetupDiGetDeviceInstanceIdW(DeviceInfoSet,
1633 int len = WideCharToMultiByte(CP_ACP, 0, instanceId, -1,
1635 DeviceInstanceIdSize, NULL, NULL);
1641 if (len > DeviceInstanceIdSize)
1643 SetLastError(ERROR_INSUFFICIENT_BUFFER);
1647 *RequiredSize = len;
1650 HeapFree(GetProcessHeap(), 0, instanceId);
1655 /***********************************************************************
1656 * SetupDiGetDeviceInstanceIdW (SETUPAPI.@)
1658 BOOL WINAPI SetupDiGetDeviceInstanceIdW(
1659 HDEVINFO DeviceInfoSet,
1660 PSP_DEVINFO_DATA DeviceInfoData,
1661 PWSTR DeviceInstanceId,
1662 DWORD DeviceInstanceIdSize,
1663 PDWORD RequiredSize)
1665 struct DeviceInfoSet *set = (struct DeviceInfoSet *)DeviceInfoSet;
1666 struct DeviceInfo *devInfo;
1668 TRACE("%p %p %p %d %p\n", DeviceInfoSet, DeviceInfoData, DeviceInstanceId,
1669 DeviceInstanceIdSize, RequiredSize);
1671 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
1673 SetLastError(ERROR_INVALID_HANDLE);
1676 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
1678 SetLastError(ERROR_INVALID_HANDLE);
1681 if (!DeviceInfoData || DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA)
1682 || !DeviceInfoData->Reserved)
1684 SetLastError(ERROR_INVALID_PARAMETER);
1687 devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
1688 if (devInfo->set != set)
1690 SetLastError(ERROR_INVALID_PARAMETER);
1693 TRACE("instance ID: %s\n", debugstr_w(devInfo->instanceId));
1694 if (DeviceInstanceIdSize < lstrlenW(devInfo->instanceId) + 1)
1696 SetLastError(ERROR_INSUFFICIENT_BUFFER);
1698 *RequiredSize = lstrlenW(devInfo->instanceId) + 1;
1701 lstrcpyW(DeviceInstanceId, devInfo->instanceId);
1703 *RequiredSize = lstrlenW(devInfo->instanceId) + 1;
1707 /***********************************************************************
1708 * SetupDiGetActualSectionToInstallA (SETUPAPI.@)
1710 BOOL WINAPI SetupDiGetActualSectionToInstallA(
1712 PCSTR InfSectionName,
1713 PSTR InfSectionWithExt,
1714 DWORD InfSectionWithExtSize,
1715 PDWORD RequiredSize,
1722 /***********************************************************************
1723 * SetupDiGetActualSectionToInstallW (SETUPAPI.@)
1725 BOOL WINAPI SetupDiGetActualSectionToInstallW(
1727 PCWSTR InfSectionName,
1728 PWSTR InfSectionWithExt,
1729 DWORD InfSectionWithExtSize,
1730 PDWORD RequiredSize,
1733 WCHAR szBuffer[MAX_PATH];
1736 LONG lLineCount = -1;
1738 lstrcpyW(szBuffer, InfSectionName);
1739 dwLength = lstrlenW(szBuffer);
1741 if (OsVersionInfo.dwPlatformId == VER_PLATFORM_WIN32_NT)
1743 /* Test section name with '.NTx86' extension */
1744 lstrcpyW(&szBuffer[dwLength], NtPlatformExtension);
1745 lLineCount = SetupGetLineCountW(InfHandle, szBuffer);
1747 if (lLineCount == -1)
1749 /* Test section name with '.NT' extension */
1750 lstrcpyW(&szBuffer[dwLength], NtExtension);
1751 lLineCount = SetupGetLineCountW(InfHandle, szBuffer);
1756 /* Test section name with '.Win' extension */
1757 lstrcpyW(&szBuffer[dwLength], WinExtension);
1758 lLineCount = SetupGetLineCountW(InfHandle, szBuffer);
1761 if (lLineCount == -1)
1763 /* Test section name without extension */
1764 szBuffer[dwLength] = 0;
1765 lLineCount = SetupGetLineCountW(InfHandle, szBuffer);
1768 if (lLineCount == -1)
1770 SetLastError(ERROR_INVALID_PARAMETER);
1774 dwFullLength = lstrlenW(szBuffer);
1776 if (InfSectionWithExt != NULL && InfSectionWithExtSize != 0)
1778 if (InfSectionWithExtSize < (dwFullLength + 1))
1780 SetLastError(ERROR_INSUFFICIENT_BUFFER);
1784 lstrcpyW(InfSectionWithExt, szBuffer);
1785 if (Extension != NULL)
1787 *Extension = (dwLength == dwFullLength) ? NULL : &InfSectionWithExt[dwLength];
1791 if (RequiredSize != NULL)
1793 *RequiredSize = dwFullLength + 1;
1799 /***********************************************************************
1800 * SetupDiGetClassDescriptionA (SETUPAPI.@)
1802 BOOL WINAPI SetupDiGetClassDescriptionA(
1803 const GUID* ClassGuid,
1804 PSTR ClassDescription,
1805 DWORD ClassDescriptionSize,
1806 PDWORD RequiredSize)
1808 return SetupDiGetClassDescriptionExA(ClassGuid, ClassDescription,
1809 ClassDescriptionSize,
1810 RequiredSize, NULL, NULL);
1813 /***********************************************************************
1814 * SetupDiGetClassDescriptionW (SETUPAPI.@)
1816 BOOL WINAPI SetupDiGetClassDescriptionW(
1817 const GUID* ClassGuid,
1818 PWSTR ClassDescription,
1819 DWORD ClassDescriptionSize,
1820 PDWORD RequiredSize)
1822 return SetupDiGetClassDescriptionExW(ClassGuid, ClassDescription,
1823 ClassDescriptionSize,
1824 RequiredSize, NULL, NULL);
1827 /***********************************************************************
1828 * SetupDiGetClassDescriptionExA (SETUPAPI.@)
1830 BOOL WINAPI SetupDiGetClassDescriptionExA(
1831 const GUID* ClassGuid,
1832 PSTR ClassDescription,
1833 DWORD ClassDescriptionSize,
1834 PDWORD RequiredSize,
1842 hKey = SetupDiOpenClassRegKeyExA(ClassGuid,
1847 if (hKey == INVALID_HANDLE_VALUE)
1849 WARN("SetupDiOpenClassRegKeyExA() failed (Error %u)\n", GetLastError());
1853 dwLength = ClassDescriptionSize;
1854 ret = !RegQueryValueExA( hKey, NULL, NULL, NULL,
1855 (LPBYTE)ClassDescription, &dwLength );
1856 if (RequiredSize) *RequiredSize = dwLength;
1861 /***********************************************************************
1862 * SetupDiGetClassDescriptionExW (SETUPAPI.@)
1864 BOOL WINAPI SetupDiGetClassDescriptionExW(
1865 const GUID* ClassGuid,
1866 PWSTR ClassDescription,
1867 DWORD ClassDescriptionSize,
1868 PDWORD RequiredSize,
1876 hKey = SetupDiOpenClassRegKeyExW(ClassGuid,
1881 if (hKey == INVALID_HANDLE_VALUE)
1883 WARN("SetupDiOpenClassRegKeyExW() failed (Error %u)\n", GetLastError());
1887 dwLength = ClassDescriptionSize * sizeof(WCHAR);
1888 ret = !RegQueryValueExW( hKey, NULL, NULL, NULL,
1889 (LPBYTE)ClassDescription, &dwLength );
1890 if (RequiredSize) *RequiredSize = dwLength / sizeof(WCHAR);
1895 /***********************************************************************
1896 * SetupDiGetClassDevsA (SETUPAPI.@)
1898 HDEVINFO WINAPI SetupDiGetClassDevsA(
1905 LPWSTR enumstrW = NULL;
1909 int len = MultiByteToWideChar(CP_ACP, 0, enumstr, -1, NULL, 0);
1910 enumstrW = HeapAlloc(GetProcessHeap(), 0, len * sizeof(WCHAR));
1913 ret = INVALID_HANDLE_VALUE;
1916 MultiByteToWideChar(CP_ACP, 0, enumstr, -1, enumstrW, len);
1918 ret = SetupDiGetClassDevsExW(class, enumstrW, parent, flags, NULL, NULL,
1920 HeapFree(GetProcessHeap(), 0, enumstrW);
1926 /***********************************************************************
1927 * SetupDiGetClassDevsExA (SETUPAPI.@)
1929 HDEVINFO WINAPI SetupDiGetClassDevsExA(
1939 LPWSTR enumstrW = NULL, machineW = NULL;
1943 int len = MultiByteToWideChar(CP_ACP, 0, enumstr, -1, NULL, 0);
1944 enumstrW = HeapAlloc(GetProcessHeap(), 0, len * sizeof(WCHAR));
1947 ret = INVALID_HANDLE_VALUE;
1950 MultiByteToWideChar(CP_ACP, 0, enumstr, -1, enumstrW, len);
1954 int len = MultiByteToWideChar(CP_ACP, 0, machine, -1, NULL, 0);
1955 machineW = HeapAlloc(GetProcessHeap(), 0, len * sizeof(WCHAR));
1958 HeapFree(GetProcessHeap(), 0, enumstrW);
1959 ret = INVALID_HANDLE_VALUE;
1962 MultiByteToWideChar(CP_ACP, 0, machine, -1, machineW, len);
1964 ret = SetupDiGetClassDevsExW(class, enumstrW, parent, flags, deviceset,
1965 machineW, reserved);
1966 HeapFree(GetProcessHeap(), 0, enumstrW);
1967 HeapFree(GetProcessHeap(), 0, machineW);
1973 static void SETUPDI_AddDeviceInterfaces(SP_DEVINFO_DATA *dev, HKEY key,
1974 const GUID *interface)
1977 WCHAR subKeyName[MAX_PATH];
1978 LONG l = ERROR_SUCCESS;
1980 for (i = 0; !l; i++)
1982 len = sizeof(subKeyName) / sizeof(subKeyName[0]);
1983 l = RegEnumKeyExW(key, i, subKeyName, &len, NULL, NULL, NULL, NULL);
1987 SP_DEVICE_INTERFACE_DATA *iface = NULL;
1989 /* The subkey name is the reference string, with a '#' prepended */
1990 SETUPDI_AddInterfaceInstance(dev, interface, subKeyName + 1,
1992 l = RegOpenKeyExW(key, subKeyName, 0, KEY_READ, &subKey);
1995 WCHAR symbolicLink[MAX_PATH];
1998 len = sizeof(symbolicLink);
1999 l = RegQueryValueExW(subKey, SymbolicLink, NULL, &dataType,
2000 (BYTE *)symbolicLink, &len);
2001 if (!l && dataType == REG_SZ)
2002 SETUPDI_SetInterfaceSymbolicLink(iface, symbolicLink);
2003 RegCloseKey(subKey);
2005 /* Allow enumeration to continue */
2009 /* FIXME: find and add all the device's interfaces to the device */
2012 static void SETUPDI_EnumerateMatchingInterfaces(HDEVINFO DeviceInfoSet,
2013 HKEY key, const GUID *interface, LPCWSTR enumstr)
2015 struct DeviceInfoSet *set = (struct DeviceInfoSet *)DeviceInfoSet;
2017 WCHAR subKeyName[MAX_PATH];
2019 HKEY enumKey = INVALID_HANDLE_VALUE;
2021 TRACE("%s\n", debugstr_w(enumstr));
2023 l = RegCreateKeyExW(HKEY_LOCAL_MACHINE, Enum, 0, NULL, 0, KEY_READ, NULL,
2025 for (i = 0; !l; i++)
2027 len = sizeof(subKeyName) / sizeof(subKeyName[0]);
2028 l = RegEnumKeyExW(key, i, subKeyName, &len, NULL, NULL, NULL, NULL);
2033 l = RegOpenKeyExW(key, subKeyName, 0, KEY_READ, &subKey);
2036 WCHAR deviceInst[MAX_PATH * 3];
2039 len = sizeof(deviceInst);
2040 l = RegQueryValueExW(subKey, DeviceInstance, NULL, &dataType,
2041 (BYTE *)deviceInst, &len);
2042 if (!l && dataType == REG_SZ)
2044 TRACE("found instance ID %s\n", debugstr_w(deviceInst));
2045 if (!enumstr || !lstrcmpiW(enumstr, deviceInst))
2049 l = RegOpenKeyExW(enumKey, deviceInst, 0, KEY_READ,
2053 WCHAR deviceClassStr[40];
2055 len = sizeof(deviceClassStr);
2056 l = RegQueryValueExW(deviceKey, ClassGUID, NULL,
2057 &dataType, (BYTE *)deviceClassStr, &len);
2058 if (!l && dataType == REG_SZ &&
2059 deviceClassStr[0] == '{' &&
2060 deviceClassStr[37] == '}')
2063 SP_DEVINFO_DATA *dev;
2065 deviceClassStr[37] = 0;
2066 UuidFromStringW(&deviceClassStr[1],
2068 if (SETUPDI_AddDeviceToSet(set, &deviceClass,
2069 0 /* FIXME: DevInst */, deviceInst,
2071 SETUPDI_AddDeviceInterfaces(dev, subKey,
2074 RegCloseKey(deviceKey);
2078 RegCloseKey(subKey);
2080 /* Allow enumeration to continue */
2084 if (enumKey != INVALID_HANDLE_VALUE)
2085 RegCloseKey(enumKey);
2088 static void SETUPDI_EnumerateInterfaces(HDEVINFO DeviceInfoSet,
2089 const GUID *interface, LPCWSTR enumstr, DWORD flags)
2091 HKEY interfacesKey = SetupDiOpenClassRegKeyExW(interface, KEY_READ,
2092 DIOCR_INTERFACE, NULL, NULL);
2094 TRACE("%p, %s, %s, %08x\n", DeviceInfoSet, debugstr_guid(interface),
2095 debugstr_w(enumstr), flags);
2097 if (interfacesKey != INVALID_HANDLE_VALUE)
2099 if (flags & DIGCF_ALLCLASSES)
2102 WCHAR interfaceGuidStr[40];
2103 LONG l = ERROR_SUCCESS;
2105 for (i = 0; !l; i++)
2107 len = sizeof(interfaceGuidStr) / sizeof(interfaceGuidStr[0]);
2108 l = RegEnumKeyExW(interfacesKey, i, interfaceGuidStr, &len,
2109 NULL, NULL, NULL, NULL);
2112 if (interfaceGuidStr[0] == '{' &&
2113 interfaceGuidStr[37] == '}')
2118 interfaceGuidStr[37] = 0;
2119 UuidFromStringW(&interfaceGuidStr[1], &interfaceGuid);
2120 l = RegOpenKeyExW(interfacesKey, interfaceGuidStr, 0,
2121 KEY_READ, &interfaceKey);
2124 SETUPDI_EnumerateMatchingInterfaces(DeviceInfoSet,
2125 interfaceKey, &interfaceGuid, enumstr);
2126 RegCloseKey(interfaceKey);
2134 /* In this case, SetupDiOpenClassRegKeyExW opened the specific
2135 * interface's key, so just pass that long
2137 SETUPDI_EnumerateMatchingInterfaces(DeviceInfoSet,
2138 interfacesKey, interface, enumstr);
2140 RegCloseKey(interfacesKey);
2144 static void SETUPDI_EnumerateMatchingDeviceInstances(struct DeviceInfoSet *set,
2145 LPCWSTR enumerator, LPCWSTR deviceName, HKEY deviceKey,
2146 const GUID *class, DWORD flags)
2149 WCHAR deviceInstance[MAX_PATH];
2150 LONG l = ERROR_SUCCESS;
2152 TRACE("%s %s\n", debugstr_w(enumerator), debugstr_w(deviceName));
2154 for (i = 0; !l; i++)
2156 len = sizeof(deviceInstance) / sizeof(deviceInstance[0]);
2157 l = RegEnumKeyExW(deviceKey, i, deviceInstance, &len, NULL, NULL, NULL,
2163 l = RegOpenKeyExW(deviceKey, deviceInstance, 0, KEY_READ, &subKey);
2166 WCHAR classGuid[40];
2169 len = sizeof(classGuid);
2170 l = RegQueryValueExW(subKey, ClassGUID, NULL, &dataType,
2171 (BYTE *)classGuid, &len);
2172 if (!l && dataType == REG_SZ)
2174 if (classGuid[0] == '{' && classGuid[37] == '}')
2179 UuidFromStringW(&classGuid[1], &deviceClass);
2180 if ((flags & DIGCF_ALLCLASSES) ||
2181 IsEqualGUID(class, &deviceClass))
2183 static const WCHAR fmt[] =
2184 {'%','s','\\','%','s','\\','%','s',0};
2187 instanceId = HeapAlloc(GetProcessHeap(), 0,
2188 (lstrlenW(enumerator) + lstrlenW(deviceName) +
2189 lstrlenW(deviceInstance) + 3) * sizeof(WCHAR));
2192 sprintfW(instanceId, fmt, enumerator,
2193 deviceName, deviceInstance);
2194 SETUPDI_AddDeviceToSet(set, &deviceClass,
2195 0 /* FIXME: DevInst */, instanceId,
2197 HeapFree(GetProcessHeap(), 0, instanceId);
2202 RegCloseKey(subKey);
2204 /* Allow enumeration to continue */
2210 static void SETUPDI_EnumerateMatchingDevices(HDEVINFO DeviceInfoSet,
2211 LPCWSTR parent, HKEY key, const GUID *class, DWORD flags)
2213 struct DeviceInfoSet *set = (struct DeviceInfoSet *)DeviceInfoSet;
2215 WCHAR subKeyName[MAX_PATH];
2216 LONG l = ERROR_SUCCESS;
2218 TRACE("%s\n", debugstr_w(parent));
2220 for (i = 0; !l; i++)
2222 len = sizeof(subKeyName) / sizeof(subKeyName[0]);
2223 l = RegEnumKeyExW(key, i, subKeyName, &len, NULL, NULL, NULL, NULL);
2228 l = RegOpenKeyExW(key, subKeyName, 0, KEY_READ, &subKey);
2231 TRACE("%s\n", debugstr_w(subKeyName));
2232 SETUPDI_EnumerateMatchingDeviceInstances(set, parent,
2233 subKeyName, subKey, class, flags);
2234 RegCloseKey(subKey);
2236 /* Allow enumeration to continue */
2242 static void SETUPDI_EnumerateDevices(HDEVINFO DeviceInfoSet, const GUID *class,
2243 LPCWSTR enumstr, DWORD flags)
2248 TRACE("%p, %s, %s, %08x\n", DeviceInfoSet, debugstr_guid(class),
2249 debugstr_w(enumstr), flags);
2251 l = RegCreateKeyExW(HKEY_LOCAL_MACHINE, Enum, 0, NULL, 0, KEY_READ, NULL,
2253 if (enumKey != INVALID_HANDLE_VALUE)
2259 l = RegOpenKeyExW(enumKey, enumstr, 0, KEY_READ,
2263 SETUPDI_EnumerateMatchingDevices(DeviceInfoSet, enumstr,
2264 enumStrKey, class, flags);
2265 RegCloseKey(enumStrKey);
2271 WCHAR subKeyName[MAX_PATH];
2274 for (i = 0; !l; i++)
2276 len = sizeof(subKeyName) / sizeof(subKeyName[0]);
2277 l = RegEnumKeyExW(enumKey, i, subKeyName, &len, NULL,
2283 l = RegOpenKeyExW(enumKey, subKeyName, 0, KEY_READ,
2287 SETUPDI_EnumerateMatchingDevices(DeviceInfoSet,
2288 subKeyName, subKey, class, flags);
2289 RegCloseKey(subKey);
2291 /* Allow enumeration to continue */
2296 RegCloseKey(enumKey);
2300 /***********************************************************************
2301 * SetupDiGetClassDevsW (SETUPAPI.@)
2303 HDEVINFO WINAPI SetupDiGetClassDevsW(
2309 return SetupDiGetClassDevsExW(class, enumstr, parent, flags, NULL, NULL,
2313 /***********************************************************************
2314 * SetupDiGetClassDevsExW (SETUPAPI.@)
2316 HDEVINFO WINAPI SetupDiGetClassDevsExW(
2325 static const DWORD unsupportedFlags = DIGCF_DEFAULT | DIGCF_PRESENT |
2329 TRACE("%s %s %p 0x%08x %p %s %p\n", debugstr_guid(class),
2330 debugstr_w(enumstr), parent, flags, deviceset, debugstr_w(machine),
2333 if (!(flags & DIGCF_ALLCLASSES) && !class)
2335 SetLastError(ERROR_INVALID_PARAMETER);
2338 if (flags & unsupportedFlags)
2339 WARN("unsupported flags %08x\n", flags & unsupportedFlags);
2343 set = SetupDiCreateDeviceInfoListExW(class, parent, machine, reserved);
2347 FIXME("%s: unimplemented for remote machines\n",
2348 debugstr_w(machine));
2349 else if (flags & DIGCF_DEVICEINTERFACE)
2350 SETUPDI_EnumerateInterfaces(set, class, enumstr, flags);
2352 SETUPDI_EnumerateDevices(set, class, enumstr, flags);
2357 /***********************************************************************
2358 * SetupDiGetDeviceInfoListDetailA (SETUPAPI.@)
2360 BOOL WINAPI SetupDiGetDeviceInfoListDetailA(
2361 HDEVINFO DeviceInfoSet,
2362 PSP_DEVINFO_LIST_DETAIL_DATA_A DevInfoData )
2364 struct DeviceInfoSet *set = (struct DeviceInfoSet *)DeviceInfoSet;
2366 TRACE("%p %p\n", DeviceInfoSet, DevInfoData);
2368 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
2370 SetLastError(ERROR_INVALID_HANDLE);
2373 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
2375 SetLastError(ERROR_INVALID_HANDLE);
2379 DevInfoData->cbSize != sizeof(SP_DEVINFO_LIST_DETAIL_DATA_A))
2381 SetLastError(ERROR_INVALID_PARAMETER);
2384 DevInfoData->ClassGuid = set->ClassGuid;
2385 DevInfoData->RemoteMachineHandle = NULL;
2386 DevInfoData->RemoteMachineName[0] = '\0';
2390 /***********************************************************************
2391 * SetupDiGetDeviceInfoListDetailW (SETUPAPI.@)
2393 BOOL WINAPI SetupDiGetDeviceInfoListDetailW(
2394 HDEVINFO DeviceInfoSet,
2395 PSP_DEVINFO_LIST_DETAIL_DATA_W DevInfoData )
2397 struct DeviceInfoSet *set = (struct DeviceInfoSet *)DeviceInfoSet;
2399 TRACE("%p %p\n", DeviceInfoSet, DevInfoData);
2401 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
2403 SetLastError(ERROR_INVALID_HANDLE);
2406 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
2408 SetLastError(ERROR_INVALID_HANDLE);
2412 DevInfoData->cbSize != sizeof(SP_DEVINFO_LIST_DETAIL_DATA_W))
2414 SetLastError(ERROR_INVALID_PARAMETER);
2417 DevInfoData->ClassGuid = set->ClassGuid;
2418 DevInfoData->RemoteMachineHandle = NULL;
2419 DevInfoData->RemoteMachineName[0] = '\0';
2423 /***********************************************************************
2424 * SetupDiCreateDeviceInterfaceA (SETUPAPI.@)
2426 BOOL WINAPI SetupDiCreateDeviceInterfaceA(
2427 HDEVINFO DeviceInfoSet,
2428 PSP_DEVINFO_DATA DeviceInfoData,
2429 const GUID *InterfaceClassGuid,
2430 PCSTR ReferenceString,
2431 DWORD CreationFlags,
2432 PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData)
2435 LPWSTR ReferenceStringW = NULL;
2437 TRACE("%p %p %s %s %08x %p\n", DeviceInfoSet, DeviceInfoData,
2438 debugstr_guid(InterfaceClassGuid), debugstr_a(ReferenceString),
2439 CreationFlags, DeviceInterfaceData);
2441 if (ReferenceString)
2443 ReferenceStringW = MultiByteToUnicode(ReferenceString, CP_ACP);
2444 if (ReferenceStringW == NULL) return FALSE;
2447 ret = SetupDiCreateDeviceInterfaceW(DeviceInfoSet, DeviceInfoData,
2448 InterfaceClassGuid, ReferenceStringW, CreationFlags,
2449 DeviceInterfaceData);
2451 MyFree(ReferenceStringW);
2456 /***********************************************************************
2457 * SetupDiCreateDeviceInterfaceW (SETUPAPI.@)
2459 BOOL WINAPI SetupDiCreateDeviceInterfaceW(
2460 HDEVINFO DeviceInfoSet,
2461 PSP_DEVINFO_DATA DeviceInfoData,
2462 const GUID *InterfaceClassGuid,
2463 PCWSTR ReferenceString,
2464 DWORD CreationFlags,
2465 PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData)
2467 struct DeviceInfoSet *set = (struct DeviceInfoSet *)DeviceInfoSet;
2468 struct DeviceInfo *devInfo;
2469 SP_DEVICE_INTERFACE_DATA *iface = NULL;
2472 TRACE("%p %p %s %s %08x %p\n", DeviceInfoSet, DeviceInfoData,
2473 debugstr_guid(InterfaceClassGuid), debugstr_w(ReferenceString),
2474 CreationFlags, DeviceInterfaceData);
2476 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
2478 SetLastError(ERROR_INVALID_HANDLE);
2481 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
2483 SetLastError(ERROR_INVALID_HANDLE);
2486 if (!DeviceInfoData || DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA)
2487 || !DeviceInfoData->Reserved)
2489 SetLastError(ERROR_INVALID_PARAMETER);
2492 devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
2493 if (devInfo->set != set)
2495 SetLastError(ERROR_INVALID_PARAMETER);
2498 if (!InterfaceClassGuid)
2500 SetLastError(ERROR_INVALID_USER_BUFFER);
2503 if ((ret = SETUPDI_AddInterfaceInstance(DeviceInfoData, InterfaceClassGuid,
2504 ReferenceString, &iface)))
2506 if (DeviceInterfaceData)
2508 if (DeviceInterfaceData->cbSize != sizeof(SP_DEVICE_INTERFACE_DATA))
2510 SetLastError(ERROR_INVALID_USER_BUFFER);
2514 *DeviceInterfaceData = *iface;
2520 /***********************************************************************
2521 * SetupDiCreateDeviceInterfaceRegKeyA (SETUPAPI.@)
2523 HKEY WINAPI SetupDiCreateDeviceInterfaceRegKeyA(
2524 HDEVINFO DeviceInfoSet,
2525 PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
2529 PCSTR InfSectionName)
2532 PWSTR InfSectionNameW = NULL;
2534 TRACE("%p %p %d %08x %p %p\n", DeviceInfoSet, DeviceInterfaceData, Reserved,
2535 samDesired, InfHandle, InfSectionName);
2538 if (!InfSectionName)
2540 SetLastError(ERROR_INVALID_PARAMETER);
2541 return INVALID_HANDLE_VALUE;
2543 InfSectionNameW = MultiByteToUnicode(InfSectionName, CP_ACP);
2544 if (!InfSectionNameW)
2545 return INVALID_HANDLE_VALUE;
2547 key = SetupDiCreateDeviceInterfaceRegKeyW(DeviceInfoSet,
2548 DeviceInterfaceData, Reserved, samDesired, InfHandle,
2550 MyFree(InfSectionNameW);
2554 static PWSTR SETUPDI_GetInstancePath(struct InterfaceInfo *ifaceInfo)
2556 static const WCHAR hash[] = {'#',0};
2557 PWSTR instancePath = NULL;
2559 if (ifaceInfo->referenceString)
2561 instancePath = HeapAlloc(GetProcessHeap(), 0,
2562 (lstrlenW(ifaceInfo->referenceString) + 2) * sizeof(WCHAR));
2565 lstrcpyW(instancePath, hash);
2566 lstrcatW(instancePath, ifaceInfo->referenceString);
2569 SetLastError(ERROR_OUTOFMEMORY);
2573 instancePath = HeapAlloc(GetProcessHeap(), 0,
2574 (lstrlenW(hash) + 1) * sizeof(WCHAR));
2576 lstrcpyW(instancePath, hash);
2578 return instancePath;
2581 /***********************************************************************
2582 * SetupDiCreateDeviceInterfaceRegKeyW (SETUPAPI.@)
2584 HKEY WINAPI SetupDiCreateDeviceInterfaceRegKeyW(
2585 HDEVINFO DeviceInfoSet,
2586 PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
2590 PCWSTR InfSectionName)
2592 struct DeviceInfoSet *set = (struct DeviceInfoSet *)DeviceInfoSet;
2593 HKEY key = INVALID_HANDLE_VALUE, interfacesKey;
2596 TRACE("%p %p %d %08x %p %p\n", DeviceInfoSet, DeviceInterfaceData, Reserved,
2597 samDesired, InfHandle, InfSectionName);
2599 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE ||
2600 set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
2602 SetLastError(ERROR_INVALID_HANDLE);
2603 return INVALID_HANDLE_VALUE;
2605 if (!DeviceInterfaceData ||
2606 DeviceInterfaceData->cbSize != sizeof(SP_DEVICE_INTERFACE_DATA) ||
2607 !DeviceInterfaceData->Reserved)
2609 SetLastError(ERROR_INVALID_PARAMETER);
2610 return INVALID_HANDLE_VALUE;
2612 if (InfHandle && !InfSectionName)
2614 SetLastError(ERROR_INVALID_PARAMETER);
2615 return INVALID_HANDLE_VALUE;
2617 if (!(l = RegCreateKeyExW(HKEY_LOCAL_MACHINE, DeviceClasses, 0, NULL, 0,
2618 samDesired, NULL, &interfacesKey, NULL)))
2621 WCHAR bracedGuidString[39];
2623 SETUPDI_GuidToString(&DeviceInterfaceData->InterfaceClassGuid,
2625 if (!(l = RegCreateKeyExW(interfacesKey, bracedGuidString, 0, NULL, 0,
2626 samDesired, NULL, &parent, NULL)))
2628 struct InterfaceInfo *ifaceInfo =
2629 (struct InterfaceInfo *)DeviceInterfaceData->Reserved;
2630 PWSTR instancePath = SETUPDI_GetInstancePath(ifaceInfo);
2636 l = RegCreateKeyExW(parent, instancePath, 0, NULL, 0,
2637 samDesired, NULL, &key, NULL);
2641 key = INVALID_HANDLE_VALUE;
2644 FIXME("INF section installation unsupported\n");
2646 HeapFree(GetProcessHeap(), 0, instancePath);
2647 RegCloseKey(parent);
2651 RegCloseKey(interfacesKey);
2658 /***********************************************************************
2659 * SetupDiDeleteDeviceInterfaceRegKey (SETUPAPI.@)
2661 BOOL WINAPI SetupDiDeleteDeviceInterfaceRegKey(
2662 HDEVINFO DeviceInfoSet,
2663 PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
2666 struct DeviceInfoSet *set = (struct DeviceInfoSet *)DeviceInfoSet;
2670 TRACE("%p %p %d\n", DeviceInfoSet, DeviceInterfaceData, Reserved);
2672 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE ||
2673 set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
2675 SetLastError(ERROR_INVALID_HANDLE);
2678 if (!DeviceInterfaceData ||
2679 DeviceInterfaceData->cbSize != sizeof(SP_DEVICE_INTERFACE_DATA) ||
2680 !DeviceInterfaceData->Reserved)
2682 SetLastError(ERROR_INVALID_PARAMETER);
2685 parent = SetupDiOpenClassRegKeyExW(&DeviceInterfaceData->InterfaceClassGuid,
2686 KEY_ALL_ACCESS, DIOCR_INTERFACE, NULL, NULL);
2687 if (parent != INVALID_HANDLE_VALUE)
2689 struct InterfaceInfo *ifaceInfo =
2690 (struct InterfaceInfo *)DeviceInterfaceData->Reserved;
2691 PWSTR instancePath = SETUPDI_GetInstancePath(ifaceInfo);
2695 LONG l = RegDeleteKeyW(parent, instancePath);
2701 HeapFree(GetProcessHeap(), 0, instancePath);
2703 RegCloseKey(parent);
2708 /***********************************************************************
2709 * SetupDiEnumDeviceInterfaces (SETUPAPI.@)
2712 * DeviceInfoSet [I] Set of devices from which to enumerate
2714 * DeviceInfoData [I] (Optional) If specified, a specific device
2715 * instance from which to enumerate interfaces.
2716 * If it isn't specified, all interfaces for all
2717 * devices in the set are enumerated.
2718 * InterfaceClassGuid [I] The interface class to enumerate.
2719 * MemberIndex [I] An index of the interface instance to enumerate.
2720 * A caller should start with MemberIndex set to 0,
2721 * and continue until the function fails with
2722 * ERROR_NO_MORE_ITEMS.
2723 * DeviceInterfaceData [I/O] Returns an enumerated interface. Its cbSize
2724 * member must be set to
2725 * sizeof(SP_DEVICE_INTERFACE_DATA).
2728 * Success: non-zero value.
2729 * Failure: FALSE. Call GetLastError() for more info.
2731 BOOL WINAPI SetupDiEnumDeviceInterfaces(
2732 HDEVINFO DeviceInfoSet,
2733 PSP_DEVINFO_DATA DeviceInfoData,
2734 CONST GUID * InterfaceClassGuid,
2736 PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData)
2738 struct DeviceInfoSet *set = (struct DeviceInfoSet *)DeviceInfoSet;
2741 TRACE("%p, %p, %s, %d, %p\n", DeviceInfoSet, DeviceInfoData,
2742 debugstr_guid(InterfaceClassGuid), MemberIndex, DeviceInterfaceData);
2744 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE ||
2745 set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
2747 SetLastError(ERROR_INVALID_HANDLE);
2750 if (DeviceInfoData && (DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA) ||
2751 !DeviceInfoData->Reserved))
2753 SetLastError(ERROR_INVALID_PARAMETER);
2756 if (!DeviceInterfaceData ||
2757 DeviceInterfaceData->cbSize != sizeof(SP_DEVICE_INTERFACE_DATA))
2759 SetLastError(ERROR_INVALID_PARAMETER);
2764 struct DeviceInfo *devInfo =
2765 (struct DeviceInfo *)DeviceInfoData->Reserved;
2766 struct InterfaceInstances *iface;
2768 if ((ret = SETUPDI_FindInterface(devInfo, InterfaceClassGuid, &iface)))
2770 if (MemberIndex < iface->cInstances)
2771 *DeviceInterfaceData = iface->instances[MemberIndex];
2774 SetLastError(ERROR_NO_MORE_ITEMS);
2779 SetLastError(ERROR_NO_MORE_ITEMS);
2783 DWORD i, cEnumerated = 0;
2786 for (i = 0; !found && cEnumerated < MemberIndex + 1 &&
2787 i < set->cDevices; i++)
2789 struct DeviceInfo *devInfo =
2790 (struct DeviceInfo *)set->devices[i].Reserved;
2791 struct InterfaceInstances *iface;
2793 if (SETUPDI_FindInterface(devInfo, InterfaceClassGuid, &iface))
2795 if (cEnumerated + iface->cInstances < MemberIndex + 1)
2796 cEnumerated += iface->cInstances;
2799 DWORD instanceIndex = MemberIndex - cEnumerated;
2801 *DeviceInterfaceData = iface->instances[instanceIndex];
2802 cEnumerated += instanceIndex + 1;
2809 SetLastError(ERROR_NO_MORE_ITEMS);
2814 /***********************************************************************
2815 * SetupDiDestroyDeviceInfoList (SETUPAPI.@)
2817 * Destroy a DeviceInfoList and free all used memory of the list.
2820 * devinfo [I] DeviceInfoList pointer to list to destroy
2823 * Success: non zero value.
2824 * Failure: zero value.
2826 BOOL WINAPI SetupDiDestroyDeviceInfoList(HDEVINFO devinfo)
2830 TRACE("%p\n", devinfo);
2831 if (devinfo && devinfo != INVALID_HANDLE_VALUE)
2833 struct DeviceInfoSet *list = (struct DeviceInfoSet *)devinfo;
2835 if (list->magic == SETUP_DEVICE_INFO_SET_MAGIC)
2839 for (i = 0; i < list->cDevices; i++)
2840 SETUPDI_FreeDeviceInfo(
2841 (struct DeviceInfo *)list->devices[i].Reserved);
2842 HeapFree(GetProcessHeap(), 0, list->devices);
2843 HeapFree(GetProcessHeap(), 0, list);
2849 SetLastError(ERROR_INVALID_HANDLE);
2854 /***********************************************************************
2855 * SetupDiGetDeviceInterfaceDetailA (SETUPAPI.@)
2857 BOOL WINAPI SetupDiGetDeviceInterfaceDetailA(
2858 HDEVINFO DeviceInfoSet,
2859 PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
2860 PSP_DEVICE_INTERFACE_DETAIL_DATA_A DeviceInterfaceDetailData,
2861 DWORD DeviceInterfaceDetailDataSize,
2862 PDWORD RequiredSize,
2863 PSP_DEVINFO_DATA DeviceInfoData)
2865 struct DeviceInfoSet *set = (struct DeviceInfoSet *)DeviceInfoSet;
2866 struct InterfaceInfo *info;
2867 DWORD bytesNeeded = offsetof(SP_DEVICE_INTERFACE_DETAIL_DATA_A, DevicePath)
2871 TRACE("(%p, %p, %p, %d, %p, %p)\n", DeviceInfoSet,
2872 DeviceInterfaceData, DeviceInterfaceDetailData,
2873 DeviceInterfaceDetailDataSize, RequiredSize, DeviceInfoData);
2875 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE ||
2876 set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
2878 SetLastError(ERROR_INVALID_HANDLE);
2881 if (!DeviceInterfaceData ||
2882 DeviceInterfaceData->cbSize != sizeof(SP_DEVICE_INTERFACE_DATA) ||
2883 !DeviceInterfaceData->Reserved)
2885 SetLastError(ERROR_INVALID_PARAMETER);
2888 if (DeviceInterfaceDetailData && (DeviceInterfaceDetailData->cbSize !=
2889 offsetof(SP_DEVICE_INTERFACE_DETAIL_DATA_A, DevicePath) + sizeof(char)))
2891 SetLastError(ERROR_INVALID_USER_BUFFER);
2894 if (!DeviceInterfaceDetailData && DeviceInterfaceDetailDataSize)
2896 SetLastError(ERROR_INVALID_USER_BUFFER);
2899 info = (struct InterfaceInfo *)DeviceInterfaceData->Reserved;
2900 if (info->symbolicLink)
2901 bytesNeeded += WideCharToMultiByte(CP_ACP, 0, info->symbolicLink, -1,
2902 NULL, 0, NULL, NULL);
2903 if (DeviceInterfaceDetailDataSize >= bytesNeeded)
2905 if (info->symbolicLink)
2906 WideCharToMultiByte(CP_ACP, 0, info->symbolicLink, -1,
2907 DeviceInterfaceDetailData->DevicePath,
2908 DeviceInterfaceDetailDataSize -
2909 offsetof(SP_DEVICE_INTERFACE_DETAIL_DATA_A, DevicePath),
2912 DeviceInterfaceDetailData->DevicePath[0] = '\0';
2913 if (DeviceInfoData && DeviceInfoData->cbSize == sizeof(SP_DEVINFO_DATA))
2914 *DeviceInfoData = *info->device;
2920 *RequiredSize = bytesNeeded;
2921 SetLastError(ERROR_INSUFFICIENT_BUFFER);
2926 /***********************************************************************
2927 * SetupDiGetDeviceInterfaceDetailW (SETUPAPI.@)
2929 BOOL WINAPI SetupDiGetDeviceInterfaceDetailW(
2930 HDEVINFO DeviceInfoSet,
2931 PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
2932 PSP_DEVICE_INTERFACE_DETAIL_DATA_W DeviceInterfaceDetailData,
2933 DWORD DeviceInterfaceDetailDataSize,
2934 PDWORD RequiredSize,
2935 PSP_DEVINFO_DATA DeviceInfoData)
2937 struct DeviceInfoSet *set = (struct DeviceInfoSet *)DeviceInfoSet;
2938 struct InterfaceInfo *info;
2939 DWORD bytesNeeded = offsetof(SP_DEVICE_INTERFACE_DETAIL_DATA_W, DevicePath)
2940 + sizeof(WCHAR); /* include NULL terminator */
2943 TRACE("(%p, %p, %p, %d, %p, %p)\n", DeviceInfoSet,
2944 DeviceInterfaceData, DeviceInterfaceDetailData,
2945 DeviceInterfaceDetailDataSize, RequiredSize, DeviceInfoData);
2947 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE ||
2948 set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
2950 SetLastError(ERROR_INVALID_HANDLE);
2953 if (!DeviceInterfaceData ||
2954 DeviceInterfaceData->cbSize != sizeof(SP_DEVICE_INTERFACE_DATA) ||
2955 !DeviceInterfaceData->Reserved)
2957 SetLastError(ERROR_INVALID_PARAMETER);
2960 if (DeviceInterfaceDetailData && (DeviceInterfaceDetailData->cbSize <
2961 offsetof(SP_DEVICE_INTERFACE_DETAIL_DATA_W, DevicePath) + sizeof(WCHAR) ||
2962 DeviceInterfaceDetailData->cbSize > sizeof(SP_DEVICE_INTERFACE_DETAIL_DATA_W)))
2964 SetLastError(ERROR_INVALID_USER_BUFFER);
2967 if (!DeviceInterfaceDetailData && DeviceInterfaceDetailDataSize)
2969 SetLastError(ERROR_INVALID_USER_BUFFER);
2972 info = (struct InterfaceInfo *)DeviceInterfaceData->Reserved;
2973 if (info->symbolicLink)
2974 bytesNeeded += lstrlenW(info->symbolicLink);
2975 if (DeviceInterfaceDetailDataSize >= bytesNeeded)
2977 if (info->symbolicLink)
2978 lstrcpyW(DeviceInterfaceDetailData->DevicePath, info->symbolicLink);
2980 DeviceInterfaceDetailData->DevicePath[0] = '\0';
2981 if (DeviceInfoData && DeviceInfoData->cbSize == sizeof(SP_DEVINFO_DATA))
2982 *DeviceInfoData = *info->device;
2988 *RequiredSize = bytesNeeded;
2989 SetLastError(ERROR_INSUFFICIENT_BUFFER);
2994 struct PropertyMapEntry
3001 static struct PropertyMapEntry PropertyMap[] = {
3002 { REG_SZ, "DeviceDesc", DeviceDesc },
3003 { REG_MULTI_SZ, "HardwareId", HardwareId },
3004 { REG_MULTI_SZ, "CompatibleIDs", CompatibleIDs },
3005 { 0, NULL, NULL }, /* SPDRP_UNUSED0 */
3006 { REG_SZ, "Service", Service },
3007 { 0, NULL, NULL }, /* SPDRP_UNUSED1 */
3008 { 0, NULL, NULL }, /* SPDRP_UNUSED2 */
3009 { REG_SZ, "Class", Class },
3010 { REG_SZ, "ClassGUID", ClassGUID },
3011 { REG_SZ, "Driver", Driver },
3012 { REG_DWORD, "ConfigFlags", ConfigFlags },
3013 { REG_SZ, "Mfg", Mfg },
3014 { REG_SZ, "FriendlyName", FriendlyName },
3015 { REG_SZ, "LocationInformation", LocationInformation },
3016 { 0, NULL, NULL }, /* SPDRP_PHYSICAL_DEVICE_OBJECT_NAME */
3017 { REG_DWORD, "Capabilities", Capabilities },
3018 { REG_DWORD, "UINumber", UINumber },
3019 { REG_MULTI_SZ, "UpperFilters", UpperFilters },
3020 { REG_MULTI_SZ, "LowerFilters", LowerFilters },
3023 /***********************************************************************
3024 * SetupDiGetDeviceRegistryPropertyA (SETUPAPI.@)
3026 BOOL WINAPI SetupDiGetDeviceRegistryPropertyA(
3027 HDEVINFO DeviceInfoSet,
3028 PSP_DEVINFO_DATA DeviceInfoData,
3030 PDWORD PropertyRegDataType,
3031 PBYTE PropertyBuffer,
3032 DWORD PropertyBufferSize,
3033 PDWORD RequiredSize)
3036 struct DeviceInfoSet *set = (struct DeviceInfoSet *)DeviceInfoSet;
3037 struct DeviceInfo *devInfo;
3039 TRACE("%04x %p %d %p %p %d %p\n", (DWORD)DeviceInfoSet, DeviceInfoData,
3040 Property, PropertyRegDataType, PropertyBuffer, PropertyBufferSize,
3043 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
3045 SetLastError(ERROR_INVALID_HANDLE);
3048 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
3050 SetLastError(ERROR_INVALID_HANDLE);
3053 if (!DeviceInfoData || DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA)
3054 || !DeviceInfoData->Reserved)
3056 SetLastError(ERROR_INVALID_PARAMETER);
3059 devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
3060 if (Property < sizeof(PropertyMap) / sizeof(PropertyMap[0])
3061 && PropertyMap[Property].nameA)
3063 DWORD size = PropertyBufferSize;
3064 LONG l = RegQueryValueExA(devInfo->key, PropertyMap[Property].nameA,
3065 NULL, PropertyRegDataType, PropertyBuffer, &size);
3068 *RequiredSize = size;
3069 if (!PropertyBuffer)
3070 ; /* do nothing, ret is already FALSE, last error is already set */
3079 /***********************************************************************
3080 * SetupDiGetDeviceRegistryPropertyW (SETUPAPI.@)
3082 BOOL WINAPI SetupDiGetDeviceRegistryPropertyW(
3083 HDEVINFO DeviceInfoSet,
3084 PSP_DEVINFO_DATA DeviceInfoData,
3086 PDWORD PropertyRegDataType,
3087 PBYTE PropertyBuffer,
3088 DWORD PropertyBufferSize,
3089 PDWORD RequiredSize)
3092 struct DeviceInfoSet *set = (struct DeviceInfoSet *)DeviceInfoSet;
3093 struct DeviceInfo *devInfo;
3095 TRACE("%04x %p %d %p %p %d %p\n", (DWORD)DeviceInfoSet, DeviceInfoData,
3096 Property, PropertyRegDataType, PropertyBuffer, PropertyBufferSize,
3099 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
3101 SetLastError(ERROR_INVALID_HANDLE);
3104 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
3106 SetLastError(ERROR_INVALID_HANDLE);
3109 if (!DeviceInfoData || DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA)
3110 || !DeviceInfoData->Reserved)
3112 SetLastError(ERROR_INVALID_PARAMETER);
3115 devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
3116 if (Property < sizeof(PropertyMap) / sizeof(PropertyMap[0])
3117 && PropertyMap[Property].nameW)
3119 DWORD size = PropertyBufferSize;
3120 LONG l = RegQueryValueExW(devInfo->key, PropertyMap[Property].nameW,
3121 NULL, PropertyRegDataType, PropertyBuffer, &size);
3124 *RequiredSize = size;
3125 if (!PropertyBuffer)
3126 ; /* do nothing, ret is already FALSE, last error is already set */
3135 /***********************************************************************
3136 * SetupDiSetDeviceRegistryPropertyA (SETUPAPI.@)
3138 BOOL WINAPI SetupDiSetDeviceRegistryPropertyA(
3139 HDEVINFO DeviceInfoSet,
3140 PSP_DEVINFO_DATA DeviceInfoData,
3142 const BYTE *PropertyBuffer,
3143 DWORD PropertyBufferSize)
3146 struct DeviceInfoSet *set = (struct DeviceInfoSet *)DeviceInfoSet;
3147 struct DeviceInfo *devInfo;
3149 TRACE("%p %p %d %p %d\n", DeviceInfoSet, DeviceInfoData, Property,
3150 PropertyBuffer, PropertyBufferSize);
3152 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
3154 SetLastError(ERROR_INVALID_HANDLE);
3157 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
3159 SetLastError(ERROR_INVALID_HANDLE);
3162 if (!DeviceInfoData || DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA)
3163 || !DeviceInfoData->Reserved)
3165 SetLastError(ERROR_INVALID_PARAMETER);
3168 devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
3169 if (Property < sizeof(PropertyMap) / sizeof(PropertyMap[0])
3170 && PropertyMap[Property].nameA)
3172 LONG l = RegSetValueExA(devInfo->key, PropertyMap[Property].nameA, 0,
3173 PropertyMap[Property].regType, PropertyBuffer,
3174 PropertyBufferSize);
3183 /***********************************************************************
3184 * SetupDiSetDeviceRegistryPropertyW (SETUPAPI.@)
3186 BOOL WINAPI SetupDiSetDeviceRegistryPropertyW(
3187 HDEVINFO DeviceInfoSet,
3188 PSP_DEVINFO_DATA DeviceInfoData,
3190 const BYTE *PropertyBuffer,
3191 DWORD PropertyBufferSize)
3194 struct DeviceInfoSet *set = (struct DeviceInfoSet *)DeviceInfoSet;
3195 struct DeviceInfo *devInfo;
3197 TRACE("%p %p %d %p %d\n", DeviceInfoSet, DeviceInfoData, Property,
3198 PropertyBuffer, PropertyBufferSize);
3200 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
3202 SetLastError(ERROR_INVALID_HANDLE);
3205 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
3207 SetLastError(ERROR_INVALID_HANDLE);
3210 if (!DeviceInfoData || DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA)
3211 || !DeviceInfoData->Reserved)
3213 SetLastError(ERROR_INVALID_PARAMETER);
3216 devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
3217 if (Property < sizeof(PropertyMap) / sizeof(PropertyMap[0])
3218 && PropertyMap[Property].nameW)
3220 LONG l = RegSetValueExW(devInfo->key, PropertyMap[Property].nameW, 0,
3221 PropertyMap[Property].regType, PropertyBuffer,
3222 PropertyBufferSize);
3231 /***********************************************************************
3232 * SetupDiInstallClassA (SETUPAPI.@)
3234 BOOL WINAPI SetupDiInstallClassA(
3240 UNICODE_STRING FileNameW;
3245 SetLastError(ERROR_INVALID_PARAMETER);
3248 if (!RtlCreateUnicodeStringFromAsciiz(&FileNameW, InfFileName))
3250 SetLastError(ERROR_NOT_ENOUGH_MEMORY);
3254 Result = SetupDiInstallClassW(hwndParent, FileNameW.Buffer, Flags, FileQueue);
3256 RtlFreeUnicodeString(&FileNameW);
3261 static HKEY CreateClassKey(HINF hInf)
3263 static const WCHAR slash[] = { '\\',0 };
3264 WCHAR FullBuffer[MAX_PATH];
3265 WCHAR Buffer[MAX_PATH];
3269 if (!SetupGetLineTextW(NULL,
3277 return INVALID_HANDLE_VALUE;
3280 lstrcpyW(FullBuffer, ControlClass);
3281 lstrcatW(FullBuffer, slash);
3282 lstrcatW(FullBuffer, Buffer);
3284 if (RegOpenKeyExW(HKEY_LOCAL_MACHINE,
3290 if (!SetupGetLineTextW(NULL,
3298 return INVALID_HANDLE_VALUE;
3301 if (RegCreateKeyExW(HKEY_LOCAL_MACHINE,
3305 REG_OPTION_NON_VOLATILE,
3311 return INVALID_HANDLE_VALUE;
3316 if (RegSetValueExW(hClassKey,
3321 RequiredSize * sizeof(WCHAR)))
3323 RegCloseKey(hClassKey);
3324 RegDeleteKeyW(HKEY_LOCAL_MACHINE,
3326 return INVALID_HANDLE_VALUE;
3332 /***********************************************************************
3333 * SetupDiInstallClassW (SETUPAPI.@)
3335 BOOL WINAPI SetupDiInstallClassW(
3341 WCHAR SectionName[MAX_PATH];
3342 DWORD SectionNameLength = 0;
3344 BOOL bFileQueueCreated = FALSE;
3352 SetLastError(ERROR_INVALID_PARAMETER);
3355 if ((Flags & DI_NOVCP) && (FileQueue == NULL || FileQueue == INVALID_HANDLE_VALUE))
3357 SetLastError(ERROR_INVALID_PARAMETER);
3361 /* Open the .inf file */
3362 hInf = SetupOpenInfFileW(InfFileName,
3366 if (hInf == INVALID_HANDLE_VALUE)
3372 /* Create or open the class registry key 'HKLM\\CurrentControlSet\\Class\\{GUID}' */
3373 hClassKey = CreateClassKey(hInf);
3374 if (hClassKey == INVALID_HANDLE_VALUE)
3376 SetupCloseInfFile(hInf);
3381 /* Try to append a layout file */
3382 SetupOpenAppendInfFileW(NULL, hInf, NULL);
3384 /* Retrieve the actual section name */
3385 SetupDiGetActualSectionToInstallW(hInf,
3393 if (!(Flags & DI_NOVCP))
3395 FileQueue = SetupOpenFileQueue();
3396 if (FileQueue == INVALID_HANDLE_VALUE)
3398 SetupCloseInfFile(hInf);
3402 bFileQueueCreated = TRUE;
3407 SetupInstallFromInfSectionW(NULL,
3410 SPINST_COPYINF | SPINST_FILES | SPINST_REGISTRY,
3416 INVALID_HANDLE_VALUE,
3419 /* FIXME: More code! */
3421 if (bFileQueueCreated)
3422 SetupCloseFileQueue(FileQueue);
3424 SetupCloseInfFile(hInf);
3430 /***********************************************************************
3431 * SetupDiOpenClassRegKey (SETUPAPI.@)
3433 HKEY WINAPI SetupDiOpenClassRegKey(
3434 const GUID* ClassGuid,
3437 return SetupDiOpenClassRegKeyExW(ClassGuid, samDesired,
3438 DIOCR_INSTALLER, NULL, NULL);
3442 /***********************************************************************
3443 * SetupDiOpenClassRegKeyExA (SETUPAPI.@)
3445 HKEY WINAPI SetupDiOpenClassRegKeyExA(
3446 const GUID* ClassGuid,
3452 PWSTR MachineNameW = NULL;
3459 MachineNameW = MultiByteToUnicode(MachineName, CP_ACP);
3460 if (MachineNameW == NULL)
3461 return INVALID_HANDLE_VALUE;
3464 hKey = SetupDiOpenClassRegKeyExW(ClassGuid, samDesired,
3465 Flags, MachineNameW, Reserved);
3467 MyFree(MachineNameW);
3473 /***********************************************************************
3474 * SetupDiOpenClassRegKeyExW (SETUPAPI.@)
3476 HKEY WINAPI SetupDiOpenClassRegKeyExW(
3477 const GUID* ClassGuid,
3488 if (MachineName != NULL)
3490 FIXME("Remote access not supported yet!\n");
3491 return INVALID_HANDLE_VALUE;
3494 if (Flags == DIOCR_INSTALLER)
3496 lpKeyName = ControlClass;
3498 else if (Flags == DIOCR_INTERFACE)
3500 lpKeyName = DeviceClasses;
3504 ERR("Invalid Flags parameter!\n");
3505 SetLastError(ERROR_INVALID_PARAMETER);
3506 return INVALID_HANDLE_VALUE;
3511 if ((l = RegOpenKeyExW(HKEY_LOCAL_MACHINE,
3518 hClassesKey = INVALID_HANDLE_VALUE;
3524 WCHAR bracedGuidString[39];
3526 SETUPDI_GuidToString(ClassGuid, bracedGuidString);
3528 if (!(l = RegOpenKeyExW(HKEY_LOCAL_MACHINE,
3534 if ((l = RegOpenKeyExW(hClassesKey,
3541 key = INVALID_HANDLE_VALUE;
3543 RegCloseKey(hClassesKey);
3548 key = INVALID_HANDLE_VALUE;
3554 /***********************************************************************
3555 * SetupDiOpenDeviceInterfaceW (SETUPAPI.@)
3557 BOOL WINAPI SetupDiOpenDeviceInterfaceW(
3558 HDEVINFO DeviceInfoSet,
3561 PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData)
3563 FIXME("%p %s %08x %p\n",
3564 DeviceInfoSet, debugstr_w(DevicePath), OpenFlags, DeviceInterfaceData);
3568 /***********************************************************************
3569 * SetupDiOpenDeviceInterfaceA (SETUPAPI.@)
3571 BOOL WINAPI SetupDiOpenDeviceInterfaceA(
3572 HDEVINFO DeviceInfoSet,
3575 PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData)
3577 FIXME("%p %s %08x %p\n", DeviceInfoSet,
3578 debugstr_a(DevicePath), OpenFlags, DeviceInterfaceData);
3582 /***********************************************************************
3583 * SetupDiSetClassInstallParamsA (SETUPAPI.@)
3585 BOOL WINAPI SetupDiSetClassInstallParamsA(
3586 HDEVINFO DeviceInfoSet,
3587 PSP_DEVINFO_DATA DeviceInfoData,
3588 PSP_CLASSINSTALL_HEADER ClassInstallParams,
3589 DWORD ClassInstallParamsSize)
3591 FIXME("%p %p %x %u\n",DeviceInfoSet, DeviceInfoData,
3592 ClassInstallParams->InstallFunction, ClassInstallParamsSize);
3596 /***********************************************************************
3597 * SetupDiCallClassInstaller (SETUPAPI.@)
3599 BOOL WINAPI SetupDiCallClassInstaller(
3600 DI_FUNCTION InstallFunction,
3601 HDEVINFO DeviceInfoSet,
3602 PSP_DEVINFO_DATA DeviceInfoData)
3604 FIXME("%d %p %p\n", InstallFunction, DeviceInfoSet, DeviceInfoData);
3608 /***********************************************************************
3609 * SetupDiGetDeviceInstallParamsA (SETUPAPI.@)
3611 BOOL WINAPI SetupDiGetDeviceInstallParamsA(
3612 HDEVINFO DeviceInfoSet,
3613 PSP_DEVINFO_DATA DeviceInfoData,
3614 PSP_DEVINSTALL_PARAMS_A DeviceInstallParams)
3616 FIXME("%p %p %p\n", DeviceInfoSet, DeviceInfoData, DeviceInstallParams);
3620 static HKEY SETUPDI_OpenDevKey(struct DeviceInfo *devInfo, REGSAM samDesired)
3622 HKEY enumKey, key = INVALID_HANDLE_VALUE;
3625 l = RegCreateKeyExW(HKEY_LOCAL_MACHINE, Enum, 0, NULL, 0, KEY_ALL_ACCESS,
3626 NULL, &enumKey, NULL);
3629 RegOpenKeyExW(enumKey, devInfo->instanceId, 0, samDesired, &key);
3630 RegCloseKey(enumKey);
3635 static HKEY SETUPDI_OpenDrvKey(struct DeviceInfo *devInfo, REGSAM samDesired)
3637 static const WCHAR slash[] = { '\\',0 };
3638 WCHAR classKeyPath[MAX_PATH];
3639 HKEY classKey, key = INVALID_HANDLE_VALUE;
3642 lstrcpyW(classKeyPath, ControlClass);
3643 lstrcatW(classKeyPath, slash);
3644 SETUPDI_GuidToString(&devInfo->set->ClassGuid,
3645 classKeyPath + lstrlenW(classKeyPath));
3646 l = RegCreateKeyExW(HKEY_LOCAL_MACHINE, classKeyPath, 0, NULL, 0,
3647 KEY_ALL_ACCESS, NULL, &classKey, NULL);
3650 static const WCHAR fmt[] = { '%','0','4','u',0 };
3653 sprintfW(devId, fmt, devInfo->devId);
3654 RegOpenKeyExW(classKey, devId, 0, samDesired, &key);
3655 RegCloseKey(classKey);
3660 /***********************************************************************
3661 * SetupDiOpenDevRegKey (SETUPAPI.@)
3663 HKEY WINAPI SetupDiOpenDevRegKey(
3664 HDEVINFO DeviceInfoSet,
3665 PSP_DEVINFO_DATA DeviceInfoData,
3671 struct DeviceInfoSet *set = (struct DeviceInfoSet *)DeviceInfoSet;
3672 struct DeviceInfo *devInfo;
3673 HKEY key = INVALID_HANDLE_VALUE;
3675 TRACE("%p %p %d %d %d %x\n", DeviceInfoSet, DeviceInfoData,
3676 Scope, HwProfile, KeyType, samDesired);
3678 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
3680 SetLastError(ERROR_INVALID_HANDLE);
3681 return INVALID_HANDLE_VALUE;
3683 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
3685 SetLastError(ERROR_INVALID_HANDLE);
3686 return INVALID_HANDLE_VALUE;
3688 if (!DeviceInfoData || DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA)
3689 || !DeviceInfoData->Reserved)
3691 SetLastError(ERROR_INVALID_PARAMETER);
3692 return INVALID_HANDLE_VALUE;
3694 if (Scope != DICS_FLAG_GLOBAL && Scope != DICS_FLAG_CONFIGSPECIFIC)
3696 SetLastError(ERROR_INVALID_FLAGS);
3697 return INVALID_HANDLE_VALUE;
3699 if (KeyType != DIREG_DEV && KeyType != DIREG_DRV)
3701 SetLastError(ERROR_INVALID_FLAGS);
3702 return INVALID_HANDLE_VALUE;
3704 devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
3705 if (devInfo->set != set)
3707 SetLastError(ERROR_INVALID_PARAMETER);
3708 return INVALID_HANDLE_VALUE;
3710 if (devInfo->phantom)
3712 SetLastError(ERROR_DEVINFO_NOT_REGISTERED);
3713 return INVALID_HANDLE_VALUE;
3715 if (Scope != DICS_FLAG_GLOBAL)
3716 FIXME("unimplemented for scope %d\n", Scope);
3720 key = SETUPDI_OpenDevKey(devInfo, samDesired);
3723 key = SETUPDI_OpenDrvKey(devInfo, samDesired);
3726 WARN("unknown KeyType %d\n", KeyType);
3731 static BOOL SETUPDI_DeleteDevKey(struct DeviceInfo *devInfo)
3737 l = RegCreateKeyExW(HKEY_LOCAL_MACHINE, Enum, 0, NULL, 0, KEY_ALL_ACCESS,
3738 NULL, &enumKey, NULL);
3741 ret = RegDeleteTreeW(enumKey, devInfo->instanceId);
3742 RegCloseKey(enumKey);
3749 static BOOL SETUPDI_DeleteDrvKey(struct DeviceInfo *devInfo)
3751 static const WCHAR slash[] = { '\\',0 };
3752 WCHAR classKeyPath[MAX_PATH];
3757 lstrcpyW(classKeyPath, ControlClass);
3758 lstrcatW(classKeyPath, slash);
3759 SETUPDI_GuidToString(&devInfo->set->ClassGuid,
3760 classKeyPath + lstrlenW(classKeyPath));
3761 l = RegCreateKeyExW(HKEY_LOCAL_MACHINE, classKeyPath, 0, NULL, 0,
3762 KEY_ALL_ACCESS, NULL, &classKey, NULL);
3765 static const WCHAR fmt[] = { '%','0','4','u',0 };
3768 sprintfW(devId, fmt, devInfo->devId);
3769 ret = RegDeleteTreeW(classKey, devId);
3770 RegCloseKey(classKey);
3777 /***********************************************************************
3778 * SetupDiOpenDevRegKey (SETUPAPI.@)
3780 BOOL WINAPI SetupDiDeleteDevRegKey(
3781 HDEVINFO DeviceInfoSet,
3782 PSP_DEVINFO_DATA DeviceInfoData,
3787 struct DeviceInfoSet *set = (struct DeviceInfoSet *)DeviceInfoSet;
3788 struct DeviceInfo *devInfo;
3791 TRACE("%p %p %d %d %d\n", DeviceInfoSet, DeviceInfoData, Scope, HwProfile,
3794 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
3796 SetLastError(ERROR_INVALID_HANDLE);
3799 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
3801 SetLastError(ERROR_INVALID_HANDLE);
3804 if (!DeviceInfoData || DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA)
3805 || !DeviceInfoData->Reserved)
3807 SetLastError(ERROR_INVALID_PARAMETER);
3810 if (Scope != DICS_FLAG_GLOBAL && Scope != DICS_FLAG_CONFIGSPECIFIC)
3812 SetLastError(ERROR_INVALID_FLAGS);
3815 if (KeyType != DIREG_DEV && KeyType != DIREG_DRV && KeyType != DIREG_BOTH)
3817 SetLastError(ERROR_INVALID_FLAGS);
3820 devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
3821 if (devInfo->set != set)
3823 SetLastError(ERROR_INVALID_PARAMETER);
3826 if (devInfo->phantom)
3828 SetLastError(ERROR_DEVINFO_NOT_REGISTERED);
3831 if (Scope != DICS_FLAG_GLOBAL)
3832 FIXME("unimplemented for scope %d\n", Scope);
3836 ret = SETUPDI_DeleteDevKey(devInfo);
3839 ret = SETUPDI_DeleteDrvKey(devInfo);
3842 ret = SETUPDI_DeleteDevKey(devInfo);
3844 ret = SETUPDI_DeleteDrvKey(devInfo);
3847 WARN("unknown KeyType %d\n", KeyType);
3852 /***********************************************************************
3853 * CM_Get_Device_IDA (SETUPAPI.@)
3855 CONFIGRET WINAPI CM_Get_Device_IDA( DEVINST dnDevInst, PSTR Buffer,
3856 ULONG BufferLen, ULONG ulFlags)
3858 struct DeviceInfo *devInfo = GlobalLock((HANDLE)dnDevInst);
3860 TRACE("%x->%p, %p, %u %u\n", dnDevInst, devInfo, Buffer, BufferLen, ulFlags);
3863 return CR_NO_SUCH_DEVINST;
3865 WideCharToMultiByte(CP_ACP, 0, devInfo->instanceId, -1, Buffer, BufferLen, 0, 0);
3866 TRACE("Returning %s\n", debugstr_a(Buffer));
3870 /***********************************************************************
3871 * CM_Get_Device_IDW (SETUPAPI.@)
3873 CONFIGRET WINAPI CM_Get_Device_IDW( DEVINST dnDevInst, LPWSTR Buffer,
3874 ULONG BufferLen, ULONG ulFlags)
3876 struct DeviceInfo *devInfo = GlobalLock((HANDLE)dnDevInst);
3878 TRACE("%x->%p, %p, %u %u\n", dnDevInst, devInfo, Buffer, BufferLen, ulFlags);
3882 WARN("dev instance %d not found!\n", dnDevInst);
3883 return CR_NO_SUCH_DEVINST;
3886 lstrcpynW(Buffer, devInfo->instanceId, BufferLen);
3887 TRACE("Returning %s\n", debugstr_w(Buffer));
3888 GlobalUnlock((HANDLE)dnDevInst);
3894 /***********************************************************************
3895 * CM_Get_Device_ID_Size (SETUPAPI.@)
3897 CONFIGRET WINAPI CM_Get_Device_ID_Size( PULONG pulLen, DEVINST dnDevInst,
3900 struct DeviceInfo *ppdevInfo = GlobalLock((HANDLE)dnDevInst);
3902 TRACE("%x->%p, %p, %u\n", dnDevInst, ppdevInfo, pulLen, ulFlags);
3906 WARN("dev instance %d not found!\n", dnDevInst);
3907 return CR_NO_SUCH_DEVINST;
3910 *pulLen = lstrlenW(ppdevInfo->instanceId);
3911 GlobalUnlock((HANDLE)dnDevInst);