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"
43 #include "setupapi_private.h"
46 WINE_DEFAULT_DEBUG_CHANNEL(setupapi);
48 /* Unicode constants */
49 static const WCHAR Chicago[] = {'$','C','h','i','c','a','g','o','$',0};
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 Signature[] = {'S','i','g','n','a','t','u','r','e',0};
59 static const WCHAR Version[] = {'V','e','r','s','i','o','n',0};
60 static const WCHAR WinExtension[] = {'.','W','i','n',0};
62 /* Registry key and value names */
63 static const WCHAR ControlClass[] = {'S','y','s','t','e','m','\\',
64 'C','u','r','r','e','n','t','C','o','n','t','r','o','l','S','e','t','\\',
65 'C','o','n','t','r','o','l','\\',
66 'C','l','a','s','s',0};
68 static const WCHAR DeviceClasses[] = {'S','y','s','t','e','m','\\',
69 'C','u','r','r','e','n','t','C','o','n','t','r','o','l','S','e','t','\\',
70 'C','o','n','t','r','o','l','\\',
71 'D','e','v','i','c','e','C','l','a','s','s','e','s',0};
72 static const WCHAR Enum[] = {'S','y','s','t','e','m','\\',
73 'C','u','r','r','e','n','t','C','o','n','t','r','o','l','S','e','t','\\',
75 static const WCHAR DeviceDesc[] = {'D','e','v','i','c','e','D','e','s','c',0};
76 static const WCHAR DeviceInstance[] = {'D','e','v','i','c','e','I','n','s','t','a','n','c','e',0};
77 static const WCHAR HardwareId[] = {'H','a','r','d','w','a','r','e','I','D',0};
78 static const WCHAR CompatibleIDs[] = {'C','o','m','p','a','t','i','b','l','e','I','d','s',0};
79 static const WCHAR Service[] = {'S','e','r','v','i','c','e',0};
80 static const WCHAR Driver[] = {'D','r','i','v','e','r',0};
81 static const WCHAR ConfigFlags[] = {'C','o','n','f','i','g','F','l','a','g','s',0};
82 static const WCHAR Mfg[] = {'M','f','g',0};
83 static const WCHAR FriendlyName[] = {'F','r','i','e','n','d','l','y','N','a','m','e',0};
84 static const WCHAR LocationInformation[] = {'L','o','c','a','t','i','o','n','I','n','f','o','r','m','a','t','i','o','n',0};
85 static const WCHAR Capabilities[] = {'C','a','p','a','b','i','l','i','t','i','e','s',0};
86 static const WCHAR UINumber[] = {'U','I','N','u','m','b','e','r',0};
87 static const WCHAR UpperFilters[] = {'U','p','p','e','r','F','i','l','t','e','r','s',0};
88 static const WCHAR LowerFilters[] = {'L','o','w','e','r','F','i','l','t','e','r','s',0};
89 static const WCHAR Phantom[] = {'P','h','a','n','t','o','m',0};
90 static const WCHAR SymbolicLink[] = {'S','y','m','b','o','l','i','c','L','i','n','k',0};
92 /* is used to identify if a DeviceInfoSet pointer is
94 #define SETUP_DEVICE_INFO_SET_MAGIC 0xd00ff056
98 DWORD magic; /* if is equal to SETUP_DEVICE_INFO_SET_MAGIC struct is okay */
105 struct DeviceInstance
108 SP_DEVINFO_DATA data;
111 /* Pointed to by SP_DEVICE_INTERFACE_DATA's Reserved member */
114 LPWSTR referenceString;
116 PSP_DEVINFO_DATA device;
119 /* A device may have multiple instances of the same interface, so this holds
120 * each instance belonging to a particular interface.
122 struct InterfaceInstances
126 DWORD cInstancesAllocated;
127 SP_DEVICE_INTERFACE_DATA *instances;
131 /* Pointed to by SP_DEVINFO_DATA's Reserved member */
134 struct DeviceInfoSet *set;
139 struct list interfaces;
142 static void SETUPDI_GuidToString(const GUID *guid, LPWSTR guidStr)
144 static const WCHAR fmt[] = {'{','%','0','8','X','-','%','0','4','X','-',
145 '%','0','4','X','-','%','0','2','X','%','0','2','X','-','%','0','2',
146 'X','%','0','2','X','%','0','2','X','%','0','2','X','%','0','2','X','%',
149 sprintfW(guidStr, fmt, guid->Data1, guid->Data2, guid->Data3,
150 guid->Data4[0], guid->Data4[1], guid->Data4[2], guid->Data4[3],
151 guid->Data4[4], guid->Data4[5], guid->Data4[6], guid->Data4[7]);
154 static void SETUPDI_FreeInterfaceInstances(struct InterfaceInstances *instances)
158 for (i = 0; i < instances->cInstances; i++)
160 struct InterfaceInfo *ifaceInfo =
161 (struct InterfaceInfo *)instances->instances[i].Reserved;
163 if (ifaceInfo->device && ifaceInfo->device->Reserved)
165 struct DeviceInfo *devInfo =
166 (struct DeviceInfo *)ifaceInfo->device->Reserved;
168 if (devInfo->phantom)
169 SetupDiDeleteDeviceInterfaceRegKey(devInfo->set,
170 &instances->instances[i], 0);
172 HeapFree(GetProcessHeap(), 0, ifaceInfo->referenceString);
173 HeapFree(GetProcessHeap(), 0, ifaceInfo->symbolicLink);
174 HeapFree(GetProcessHeap(), 0, ifaceInfo);
176 HeapFree(GetProcessHeap(), 0, instances->instances);
179 /* Finds the interface with interface class InterfaceClassGuid in the device.
180 * Returns TRUE if found, and updates *interface to point to device's
181 * interfaces member where the given interface was found.
182 * Returns FALSE if not found.
184 static BOOL SETUPDI_FindInterface(const struct DeviceInfo *devInfo,
185 const GUID *InterfaceClassGuid, struct InterfaceInstances **iface_ret)
188 struct InterfaceInstances *iface;
190 TRACE("%s\n", debugstr_guid(InterfaceClassGuid));
192 LIST_FOR_EACH_ENTRY(iface, &devInfo->interfaces, struct InterfaceInstances,
195 if (IsEqualGUID(&iface->guid, InterfaceClassGuid))
202 TRACE("returning %d (%p)\n", found, found ? *iface_ret : NULL);
206 /* Finds the interface instance with reference string ReferenceString in the
207 * interface instance map. Returns TRUE if found, and updates instanceIndex to
208 * the index of the interface instance's instances member
209 * where the given instance was found. Returns FALSE if not found.
211 static BOOL SETUPDI_FindInterfaceInstance(
212 const struct InterfaceInstances *instances,
213 LPCWSTR ReferenceString, DWORD *instanceIndex)
218 TRACE("%s\n", debugstr_w(ReferenceString));
220 for (i = 0; !found && i < instances->cInstances; i++)
222 SP_DEVICE_INTERFACE_DATA *ifaceData = &instances->instances[i];
223 struct InterfaceInfo *ifaceInfo =
224 (struct InterfaceInfo *)ifaceData->Reserved;
226 if (!ReferenceString && !ifaceInfo->referenceString)
231 else if (ReferenceString && ifaceInfo->referenceString &&
232 !lstrcmpiW(ifaceInfo->referenceString, ReferenceString))
238 TRACE("returning %d (%d)\n", found, found ? *instanceIndex : 0);
242 static LPWSTR SETUPDI_CreateSymbolicLinkPath(LPCWSTR instanceId,
243 const GUID *InterfaceClassGuid, LPCWSTR ReferenceString)
245 static const WCHAR fmt[] = {'\\','\\','?','\\','%','s','#','%','s',0};
250 SETUPDI_GuidToString(InterfaceClassGuid, guidStr);
251 /* omit length of format specifiers, but include NULL terminator: */
252 len = lstrlenW(fmt) - 4 + 1;
253 len += lstrlenW(instanceId) + lstrlenW(guidStr);
254 if (ReferenceString && *ReferenceString)
256 /* space for a hash between string and reference string: */
257 len += lstrlenW(ReferenceString) + 1;
259 ret = HeapAlloc(GetProcessHeap(), 0, len * sizeof(WCHAR));
262 int printed = sprintfW(ret, fmt, instanceId, guidStr);
265 /* replace '\\' with '#' after the "\\\\?\\" beginning */
266 for (ptr = strchrW(ret + 4, '\\'); ptr; ptr = strchrW(ptr + 1, '\\'))
268 if (ReferenceString && *ReferenceString)
271 lstrcpyW(ret + printed + 1, ReferenceString);
277 /* Adds an interface with the given interface class and reference string to
278 * the device, if it doesn't already exist in the device. If iface is not
279 * NULL, returns a pointer to the newly added (or already existing) interface.
281 static BOOL SETUPDI_AddInterfaceInstance(PSP_DEVINFO_DATA DeviceInfoData,
282 const GUID *InterfaceClassGuid, LPCWSTR ReferenceString,
283 SP_DEVICE_INTERFACE_DATA **ifaceData)
285 struct DeviceInfo *devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
286 BOOL newInterface = FALSE, ret;
287 struct InterfaceInstances *iface = NULL;
289 TRACE("%p %s %s %p\n", devInfo, debugstr_guid(InterfaceClassGuid),
290 debugstr_w(ReferenceString), iface);
292 if (!(ret = SETUPDI_FindInterface(devInfo, InterfaceClassGuid, &iface)))
294 iface = HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY,
295 sizeof(struct InterfaceInstances));
298 list_add_tail(&devInfo->interfaces, &iface->entry);
304 DWORD instanceIndex = 0;
306 if (!(ret = SETUPDI_FindInterfaceInstance(iface, ReferenceString,
309 SP_DEVICE_INTERFACE_DATA *instance = NULL;
311 if (!iface->cInstancesAllocated)
313 iface->instances = HeapAlloc(GetProcessHeap(), 0,
314 sizeof(SP_DEVICE_INTERFACE_DATA));
315 if (iface->instances)
316 instance = &iface->instances[iface->cInstancesAllocated++];
318 else if (iface->cInstances == iface->cInstancesAllocated)
320 iface->instances = HeapReAlloc(GetProcessHeap(), 0,
322 (iface->cInstancesAllocated + 1) *
323 sizeof(SP_DEVICE_INTERFACE_DATA));
324 if (iface->instances)
325 instance = &iface->instances[iface->cInstancesAllocated++];
328 instance = &iface->instances[iface->cInstances];
331 struct InterfaceInfo *ifaceInfo = HeapAlloc(GetProcessHeap(),
332 0, sizeof(struct InterfaceInfo));
337 ifaceInfo->device = DeviceInfoData;
338 ifaceInfo->symbolicLink = SETUPDI_CreateSymbolicLinkPath(
339 devInfo->instanceId, InterfaceClassGuid,
343 ifaceInfo->referenceString =
344 HeapAlloc(GetProcessHeap(), 0,
345 (lstrlenW(ReferenceString) + 1) *
347 if (ifaceInfo->referenceString)
348 lstrcpyW(ifaceInfo->referenceString,
354 ifaceInfo->referenceString = NULL;
361 sizeof(SP_DEVICE_INTERFACE_DATA);
362 instance->InterfaceClassGuid = *InterfaceClassGuid;
363 instance->Flags = SPINT_ACTIVE; /* FIXME */
364 instance->Reserved = (ULONG_PTR)ifaceInfo;
366 iface->guid = *InterfaceClassGuid;
367 key = SetupDiCreateDeviceInterfaceRegKeyW(devInfo->set,
368 instance, 0, KEY_WRITE, NULL, NULL);
369 if (key != INVALID_HANDLE_VALUE)
371 RegSetValueExW(key, SymbolicLink, 0, REG_SZ,
372 (BYTE *)ifaceInfo->symbolicLink,
373 lstrlenW(ifaceInfo->symbolicLink) *
378 *ifaceData = instance;
381 HeapFree(GetProcessHeap(), 0, ifaceInfo);
388 *ifaceData = &iface->instances[instanceIndex];
393 TRACE("returning %d\n", ret);
397 static BOOL SETUPDI_SetInterfaceSymbolicLink(SP_DEVICE_INTERFACE_DATA *iface,
398 LPCWSTR symbolicLink)
400 struct InterfaceInfo *info = (struct InterfaceInfo *)iface->Reserved;
405 HeapFree(GetProcessHeap(), 0, info->symbolicLink);
406 info->symbolicLink = HeapAlloc(GetProcessHeap(), 0,
407 (lstrlenW(symbolicLink) + 1) * sizeof(WCHAR));
408 if (info->symbolicLink)
410 lstrcpyW(info->symbolicLink, symbolicLink);
417 static HKEY SETUPDI_CreateDevKey(struct DeviceInfo *devInfo)
419 HKEY enumKey, key = INVALID_HANDLE_VALUE;
422 l = RegCreateKeyExW(HKEY_LOCAL_MACHINE, Enum, 0, NULL, 0, KEY_ALL_ACCESS,
423 NULL, &enumKey, NULL);
426 RegCreateKeyExW(enumKey, devInfo->instanceId, 0, NULL, 0,
427 KEY_READ | KEY_WRITE, NULL, &key, NULL);
428 RegCloseKey(enumKey);
433 static HKEY SETUPDI_CreateDrvKey(struct DeviceInfo *devInfo)
435 static const WCHAR slash[] = { '\\',0 };
436 WCHAR classKeyPath[MAX_PATH];
437 HKEY classKey, key = INVALID_HANDLE_VALUE;
440 lstrcpyW(classKeyPath, ControlClass);
441 lstrcatW(classKeyPath, slash);
442 SETUPDI_GuidToString(&devInfo->set->ClassGuid,
443 classKeyPath + lstrlenW(classKeyPath));
444 l = RegCreateKeyExW(HKEY_LOCAL_MACHINE, classKeyPath, 0, NULL, 0,
445 KEY_ALL_ACCESS, NULL, &classKey, NULL);
448 static const WCHAR fmt[] = { '%','0','4','u',0 };
451 sprintfW(devId, fmt, devInfo->devId);
452 RegCreateKeyExW(classKey, devId, 0, NULL, 0, KEY_READ | KEY_WRITE,
454 RegCloseKey(classKey);
459 static struct DeviceInfo *SETUPDI_AllocateDeviceInfo(struct DeviceInfoSet *set,
460 DWORD devId, LPCWSTR instanceId, BOOL phantom)
462 struct DeviceInfo *devInfo = NULL;
463 HANDLE devInst = GlobalAlloc(GMEM_FIXED, sizeof(struct DeviceInfo));
465 devInfo = GlobalLock(devInst);
470 devInfo->devId = (DWORD)devInst;
472 devInfo->instanceId = HeapAlloc(GetProcessHeap(), 0,
473 (lstrlenW(instanceId) + 1) * sizeof(WCHAR));
474 if (devInfo->instanceId)
476 devInfo->key = INVALID_HANDLE_VALUE;
477 devInfo->phantom = phantom;
478 lstrcpyW(devInfo->instanceId, instanceId);
479 struprW(devInfo->instanceId);
480 devInfo->key = SETUPDI_CreateDevKey(devInfo);
481 if (devInfo->key != INVALID_HANDLE_VALUE)
484 RegSetValueExW(devInfo->key, Phantom, 0, REG_DWORD,
485 (LPBYTE)&phantom, sizeof(phantom));
487 list_init(&devInfo->interfaces);
488 GlobalUnlock(devInst);
492 GlobalUnlock(devInst);
500 static void SETUPDI_FreeDeviceInfo(struct DeviceInfo *devInfo)
502 struct InterfaceInstances *iface, *next;
504 if (devInfo->key != INVALID_HANDLE_VALUE)
505 RegCloseKey(devInfo->key);
506 if (devInfo->phantom)
511 l = RegCreateKeyExW(HKEY_LOCAL_MACHINE, Enum, 0, NULL, 0,
512 KEY_ALL_ACCESS, NULL, &enumKey, NULL);
515 RegDeleteTreeW(enumKey, devInfo->instanceId);
516 RegCloseKey(enumKey);
519 HeapFree(GetProcessHeap(), 0, devInfo->instanceId);
520 LIST_FOR_EACH_ENTRY_SAFE(iface, next, &devInfo->interfaces,
521 struct InterfaceInstances, entry)
523 list_remove(&iface->entry);
524 SETUPDI_FreeInterfaceInstances(iface);
525 HeapFree(GetProcessHeap(), 0, iface);
527 GlobalFree((HANDLE)devInfo->devId);
530 /* Adds a device with GUID guid and identifier devInst to set. Allocates a
531 * struct DeviceInfo, and points the returned device info's Reserved member
532 * to it. "Phantom" devices are deleted from the registry when closed.
533 * Returns a pointer to the newly allocated device info.
535 static BOOL SETUPDI_AddDeviceToSet(struct DeviceInfoSet *set,
540 SP_DEVINFO_DATA **dev)
543 struct DeviceInfo *devInfo = SETUPDI_AllocateDeviceInfo(set, set->cDevices,
544 instanceId, phantom);
546 TRACE("%p, %s, %d, %s, %d\n", set, debugstr_guid(guid), devInst,
547 debugstr_w(instanceId), phantom);
551 struct DeviceInstance *devInst =
552 HeapAlloc(GetProcessHeap(), 0, sizeof(struct DeviceInstance));
556 WCHAR classGuidStr[39];
558 list_add_tail(&set->devices, &devInst->entry);
560 devInst->data.cbSize = sizeof(SP_DEVINFO_DATA);
561 devInst->data.ClassGuid = *guid;
562 devInst->data.DevInst = devInfo->devId;
563 devInst->data.Reserved = (ULONG_PTR)devInfo;
564 SETUPDI_GuidToString(guid, classGuidStr);
565 SetupDiSetDeviceRegistryPropertyW(set, &devInst->data,
566 SPDRP_CLASSGUID, (const BYTE *)classGuidStr,
567 lstrlenW(classGuidStr) * sizeof(WCHAR));
568 if (dev) *dev = &devInst->data;
573 HeapFree(GetProcessHeap(), 0, devInfo);
574 SetLastError(ERROR_OUTOFMEMORY);
580 /***********************************************************************
581 * SetupDiBuildClassInfoList (SETUPAPI.@)
583 * Returns a list of setup class GUIDs that identify the classes
584 * that are installed on a local machine.
587 * Flags [I] control exclusion of classes from the list.
588 * ClassGuidList [O] pointer to a GUID-typed array that receives a list of setup class GUIDs.
589 * ClassGuidListSize [I] The number of GUIDs in the array (ClassGuidList).
590 * RequiredSize [O] pointer, which receives the number of GUIDs that are returned.
596 BOOL WINAPI SetupDiBuildClassInfoList(
598 LPGUID ClassGuidList,
599 DWORD ClassGuidListSize,
603 return SetupDiBuildClassInfoListExW(Flags, ClassGuidList,
604 ClassGuidListSize, RequiredSize,
608 /***********************************************************************
609 * SetupDiBuildClassInfoListExA (SETUPAPI.@)
611 * Returns a list of setup class GUIDs that identify the classes
612 * that are installed on a local or remote machine.
615 * Flags [I] control exclusion of classes from the list.
616 * ClassGuidList [O] pointer to a GUID-typed array that receives a list of setup class GUIDs.
617 * ClassGuidListSize [I] The number of GUIDs in the array (ClassGuidList).
618 * RequiredSize [O] pointer, which receives the number of GUIDs that are returned.
619 * MachineName [I] name of a remote machine.
620 * Reserved [I] must be NULL.
626 BOOL WINAPI SetupDiBuildClassInfoListExA(
628 LPGUID ClassGuidList,
629 DWORD ClassGuidListSize,
634 LPWSTR MachineNameW = NULL;
641 MachineNameW = MultiByteToUnicode(MachineName, CP_ACP);
642 if (MachineNameW == NULL) return FALSE;
645 bResult = SetupDiBuildClassInfoListExW(Flags, ClassGuidList,
646 ClassGuidListSize, RequiredSize,
647 MachineNameW, Reserved);
649 MyFree(MachineNameW);
654 /***********************************************************************
655 * SetupDiBuildClassInfoListExW (SETUPAPI.@)
657 * Returns a list of setup class GUIDs that identify the classes
658 * that are installed on a local or remote machine.
661 * Flags [I] control exclusion of classes from the list.
662 * ClassGuidList [O] pointer to a GUID-typed array that receives a list of setup class GUIDs.
663 * ClassGuidListSize [I] The number of GUIDs in the array (ClassGuidList).
664 * RequiredSize [O] pointer, which receives the number of GUIDs that are returned.
665 * MachineName [I] name of a remote machine.
666 * Reserved [I] must be NULL.
672 BOOL WINAPI SetupDiBuildClassInfoListExW(
674 LPGUID ClassGuidList,
675 DWORD ClassGuidListSize,
686 DWORD dwGuidListIndex = 0;
690 if (RequiredSize != NULL)
693 hClassesKey = SetupDiOpenClassRegKeyExW(NULL,
698 if (hClassesKey == INVALID_HANDLE_VALUE)
703 for (dwIndex = 0; ; dwIndex++)
706 lError = RegEnumKeyExW(hClassesKey,
714 TRACE("RegEnumKeyExW() returns %d\n", lError);
715 if (lError == ERROR_SUCCESS || lError == ERROR_MORE_DATA)
717 TRACE("Key name: %p\n", szKeyName);
719 if (RegOpenKeyExW(hClassesKey,
725 RegCloseKey(hClassesKey);
729 if (!RegQueryValueExW(hClassKey,
736 TRACE("'NoUseClass' value found!\n");
737 RegCloseKey(hClassKey);
741 if ((Flags & DIBCI_NOINSTALLCLASS) &&
742 (!RegQueryValueExW(hClassKey,
749 TRACE("'NoInstallClass' value found!\n");
750 RegCloseKey(hClassKey);
754 if ((Flags & DIBCI_NODISPLAYCLASS) &&
755 (!RegQueryValueExW(hClassKey,
762 TRACE("'NoDisplayClass' value found!\n");
763 RegCloseKey(hClassKey);
767 RegCloseKey(hClassKey);
769 TRACE("Guid: %p\n", szKeyName);
770 if (dwGuidListIndex < ClassGuidListSize)
772 if (szKeyName[0] == '{' && szKeyName[37] == '}')
776 TRACE("Guid: %p\n", &szKeyName[1]);
778 UuidFromStringW(&szKeyName[1],
779 &ClassGuidList[dwGuidListIndex]);
785 if (lError != ERROR_SUCCESS)
789 RegCloseKey(hClassesKey);
791 if (RequiredSize != NULL)
792 *RequiredSize = dwGuidListIndex;
794 if (ClassGuidListSize < dwGuidListIndex)
796 SetLastError(ERROR_INSUFFICIENT_BUFFER);
803 /***********************************************************************
804 * SetupDiClassGuidsFromNameA (SETUPAPI.@)
806 BOOL WINAPI SetupDiClassGuidsFromNameA(
808 LPGUID ClassGuidList,
809 DWORD ClassGuidListSize,
812 return SetupDiClassGuidsFromNameExA(ClassName, ClassGuidList,
813 ClassGuidListSize, RequiredSize,
817 /***********************************************************************
818 * SetupDiClassGuidsFromNameW (SETUPAPI.@)
820 BOOL WINAPI SetupDiClassGuidsFromNameW(
822 LPGUID ClassGuidList,
823 DWORD ClassGuidListSize,
826 return SetupDiClassGuidsFromNameExW(ClassName, ClassGuidList,
827 ClassGuidListSize, RequiredSize,
831 /***********************************************************************
832 * SetupDiClassGuidsFromNameExA (SETUPAPI.@)
834 BOOL WINAPI SetupDiClassGuidsFromNameExA(
836 LPGUID ClassGuidList,
837 DWORD ClassGuidListSize,
842 LPWSTR ClassNameW = NULL;
843 LPWSTR MachineNameW = NULL;
846 ClassNameW = MultiByteToUnicode(ClassName, CP_ACP);
847 if (ClassNameW == NULL)
852 MachineNameW = MultiByteToUnicode(MachineName, CP_ACP);
853 if (MachineNameW == NULL)
860 bResult = SetupDiClassGuidsFromNameExW(ClassNameW, ClassGuidList,
861 ClassGuidListSize, RequiredSize,
862 MachineNameW, Reserved);
864 MyFree(MachineNameW);
870 /***********************************************************************
871 * SetupDiClassGuidsFromNameExW (SETUPAPI.@)
873 BOOL WINAPI SetupDiClassGuidsFromNameExW(
875 LPGUID ClassGuidList,
876 DWORD ClassGuidListSize,
882 WCHAR szClassName[256];
888 DWORD dwGuidListIndex = 0;
890 if (RequiredSize != NULL)
893 hClassesKey = SetupDiOpenClassRegKeyExW(NULL,
898 if (hClassesKey == INVALID_HANDLE_VALUE)
903 for (dwIndex = 0; ; dwIndex++)
906 lError = RegEnumKeyExW(hClassesKey,
914 TRACE("RegEnumKeyExW() returns %d\n", lError);
915 if (lError == ERROR_SUCCESS || lError == ERROR_MORE_DATA)
917 TRACE("Key name: %p\n", szKeyName);
919 if (RegOpenKeyExW(hClassesKey,
925 RegCloseKey(hClassesKey);
929 dwLength = 256 * sizeof(WCHAR);
930 if (!RegQueryValueExW(hClassKey,
937 TRACE("Class name: %p\n", szClassName);
939 if (strcmpiW(szClassName, ClassName) == 0)
941 TRACE("Found matching class name\n");
943 TRACE("Guid: %p\n", szKeyName);
944 if (dwGuidListIndex < ClassGuidListSize)
946 if (szKeyName[0] == '{' && szKeyName[37] == '}')
950 TRACE("Guid: %p\n", &szKeyName[1]);
952 UuidFromStringW(&szKeyName[1],
953 &ClassGuidList[dwGuidListIndex]);
960 RegCloseKey(hClassKey);
963 if (lError != ERROR_SUCCESS)
967 RegCloseKey(hClassesKey);
969 if (RequiredSize != NULL)
970 *RequiredSize = dwGuidListIndex;
972 if (ClassGuidListSize < dwGuidListIndex)
974 SetLastError(ERROR_INSUFFICIENT_BUFFER);
981 /***********************************************************************
982 * SetupDiClassNameFromGuidA (SETUPAPI.@)
984 BOOL WINAPI SetupDiClassNameFromGuidA(
985 const GUID* ClassGuid,
990 return SetupDiClassNameFromGuidExA(ClassGuid, ClassName,
991 ClassNameSize, RequiredSize,
995 /***********************************************************************
996 * SetupDiClassNameFromGuidW (SETUPAPI.@)
998 BOOL WINAPI SetupDiClassNameFromGuidW(
999 const GUID* ClassGuid,
1001 DWORD ClassNameSize,
1002 PDWORD RequiredSize)
1004 return SetupDiClassNameFromGuidExW(ClassGuid, ClassName,
1005 ClassNameSize, RequiredSize,
1009 /***********************************************************************
1010 * SetupDiClassNameFromGuidExA (SETUPAPI.@)
1012 BOOL WINAPI SetupDiClassNameFromGuidExA(
1013 const GUID* ClassGuid,
1015 DWORD ClassNameSize,
1016 PDWORD RequiredSize,
1020 WCHAR ClassNameW[MAX_CLASS_NAME_LEN];
1021 LPWSTR MachineNameW = NULL;
1025 MachineNameW = MultiByteToUnicode(MachineName, CP_ACP);
1026 ret = SetupDiClassNameFromGuidExW(ClassGuid, ClassNameW, MAX_CLASS_NAME_LEN,
1027 NULL, MachineNameW, Reserved);
1030 int len = WideCharToMultiByte(CP_ACP, 0, ClassNameW, -1, ClassName,
1031 ClassNameSize, NULL, NULL);
1033 if (!ClassNameSize && RequiredSize)
1034 *RequiredSize = len;
1036 MyFree(MachineNameW);
1040 /***********************************************************************
1041 * SetupDiClassNameFromGuidExW (SETUPAPI.@)
1043 BOOL WINAPI SetupDiClassNameFromGuidExW(
1044 const GUID* ClassGuid,
1046 DWORD ClassNameSize,
1047 PDWORD RequiredSize,
1054 hKey = SetupDiOpenClassRegKeyExW(ClassGuid,
1059 if (hKey == INVALID_HANDLE_VALUE)
1064 if (RequiredSize != NULL)
1067 if (RegQueryValueExW(hKey,
1078 *RequiredSize = dwLength / sizeof(WCHAR);
1081 dwLength = ClassNameSize * sizeof(WCHAR);
1082 if (RegQueryValueExW(hKey,
1098 /***********************************************************************
1099 * SetupDiCreateDeviceInfoList (SETUPAPI.@)
1102 SetupDiCreateDeviceInfoList(const GUID *ClassGuid,
1105 return SetupDiCreateDeviceInfoListExW(ClassGuid, hwndParent, NULL, NULL);
1108 /***********************************************************************
1109 * SetupDiCreateDeviceInfoListExA (SETUPAPI.@)
1112 SetupDiCreateDeviceInfoListExA(const GUID *ClassGuid,
1117 LPWSTR MachineNameW = NULL;
1124 MachineNameW = MultiByteToUnicode(MachineName, CP_ACP);
1125 if (MachineNameW == NULL)
1126 return INVALID_HANDLE_VALUE;
1129 hDevInfo = SetupDiCreateDeviceInfoListExW(ClassGuid, hwndParent,
1130 MachineNameW, Reserved);
1132 MyFree(MachineNameW);
1137 /***********************************************************************
1138 * SetupDiCreateDeviceInfoListExW (SETUPAPI.@)
1140 * Create an empty DeviceInfoSet list.
1143 * ClassGuid [I] if not NULL only devices with GUID ClassGuid are associated
1145 * hwndParent [I] hwnd needed for interface related actions.
1146 * MachineName [I] name of machine to create emtpy DeviceInfoSet list, if NULL
1147 * local registry will be used.
1148 * Reserved [I] must be NULL
1151 * Success: empty list.
1152 * Failure: INVALID_HANDLE_VALUE.
1155 SetupDiCreateDeviceInfoListExW(const GUID *ClassGuid,
1160 struct DeviceInfoSet *list = NULL;
1161 DWORD size = sizeof(struct DeviceInfoSet);
1163 TRACE("%s %p %s %p\n", debugstr_guid(ClassGuid), hwndParent,
1164 debugstr_w(MachineName), Reserved);
1166 if (MachineName && *MachineName)
1168 FIXME("remote support is not implemented\n");
1169 SetLastError(ERROR_INVALID_MACHINENAME);
1170 return INVALID_HANDLE_VALUE;
1173 if (Reserved != NULL)
1175 SetLastError(ERROR_INVALID_PARAMETER);
1176 return INVALID_HANDLE_VALUE;
1179 list = HeapAlloc(GetProcessHeap(), 0, size);
1182 SetLastError(ERROR_NOT_ENOUGH_MEMORY);
1183 return INVALID_HANDLE_VALUE;
1186 list->magic = SETUP_DEVICE_INFO_SET_MAGIC;
1187 list->hwndParent = hwndParent;
1188 memcpy(&list->ClassGuid,
1189 ClassGuid ? ClassGuid : &GUID_NULL,
1190 sizeof(list->ClassGuid));
1192 list_init(&list->devices);
1197 /***********************************************************************
1198 * SetupDiCreateDevRegKeyA (SETUPAPI.@)
1200 HKEY WINAPI SetupDiCreateDevRegKeyA(
1201 HDEVINFO DeviceInfoSet,
1202 PSP_DEVINFO_DATA DeviceInfoData,
1207 PCSTR InfSectionName)
1209 PWSTR InfSectionNameW = NULL;
1212 TRACE("%p %p %d %d %d %p %s\n", DeviceInfoSet, DeviceInfoData, Scope,
1213 HwProfile, KeyType, InfHandle, debugstr_a(InfSectionName));
1217 if (!InfSectionName)
1219 SetLastError(ERROR_INVALID_PARAMETER);
1220 return INVALID_HANDLE_VALUE;
1224 InfSectionNameW = MultiByteToUnicode(InfSectionName, CP_ACP);
1225 if (InfSectionNameW == NULL) return INVALID_HANDLE_VALUE;
1228 key = SetupDiCreateDevRegKeyW(DeviceInfoSet, DeviceInfoData, Scope,
1229 HwProfile, KeyType, InfHandle, InfSectionNameW);
1230 MyFree(InfSectionNameW);
1234 /***********************************************************************
1235 * SetupDiCreateDevRegKeyW (SETUPAPI.@)
1237 HKEY WINAPI SetupDiCreateDevRegKeyW(
1238 HDEVINFO DeviceInfoSet,
1239 PSP_DEVINFO_DATA DeviceInfoData,
1244 PCWSTR InfSectionName)
1246 struct DeviceInfoSet *set = DeviceInfoSet;
1247 struct DeviceInfo *devInfo;
1248 HKEY key = INVALID_HANDLE_VALUE;
1250 TRACE("%p %p %d %d %d %p %s\n", DeviceInfoSet, DeviceInfoData, Scope,
1251 HwProfile, KeyType, InfHandle, debugstr_w(InfSectionName));
1253 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
1255 SetLastError(ERROR_INVALID_HANDLE);
1256 return INVALID_HANDLE_VALUE;
1258 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
1260 SetLastError(ERROR_INVALID_HANDLE);
1261 return INVALID_HANDLE_VALUE;
1263 if (!DeviceInfoData || DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA)
1264 || !DeviceInfoData->Reserved)
1266 SetLastError(ERROR_INVALID_PARAMETER);
1267 return INVALID_HANDLE_VALUE;
1269 devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
1270 if (devInfo->set != set)
1272 SetLastError(ERROR_INVALID_PARAMETER);
1273 return INVALID_HANDLE_VALUE;
1275 if (Scope != DICS_FLAG_GLOBAL && Scope != DICS_FLAG_CONFIGSPECIFIC)
1277 SetLastError(ERROR_INVALID_FLAGS);
1278 return INVALID_HANDLE_VALUE;
1280 if (KeyType != DIREG_DEV && KeyType != DIREG_DRV)
1282 SetLastError(ERROR_INVALID_FLAGS);
1283 return INVALID_HANDLE_VALUE;
1285 if (devInfo->phantom)
1287 SetLastError(ERROR_DEVINFO_NOT_REGISTERED);
1288 return INVALID_HANDLE_VALUE;
1290 if (Scope != DICS_FLAG_GLOBAL)
1291 FIXME("unimplemented for scope %d\n", Scope);
1295 key = SETUPDI_CreateDevKey(devInfo);
1298 key = SETUPDI_CreateDrvKey(devInfo);
1301 WARN("unknown KeyType %d\n", KeyType);
1304 SetupInstallFromInfSectionW(NULL, InfHandle, InfSectionName, SPINST_ALL,
1305 NULL, NULL, SP_COPY_NEWER_ONLY, NULL, NULL, DeviceInfoSet,
1310 /***********************************************************************
1311 * SetupDiCreateDeviceInfoA (SETUPAPI.@)
1313 BOOL WINAPI SetupDiCreateDeviceInfoA(
1314 HDEVINFO DeviceInfoSet,
1316 CONST GUID *ClassGuid,
1317 PCSTR DeviceDescription,
1319 DWORD CreationFlags,
1320 PSP_DEVINFO_DATA DeviceInfoData)
1323 LPWSTR DeviceNameW = NULL;
1324 LPWSTR DeviceDescriptionW = NULL;
1328 DeviceNameW = MultiByteToUnicode(DeviceName, CP_ACP);
1329 if (DeviceNameW == NULL) return FALSE;
1331 if (DeviceDescription)
1333 DeviceDescriptionW = MultiByteToUnicode(DeviceDescription, CP_ACP);
1334 if (DeviceDescriptionW == NULL)
1336 MyFree(DeviceNameW);
1341 ret = SetupDiCreateDeviceInfoW(DeviceInfoSet, DeviceNameW, ClassGuid, DeviceDescriptionW,
1342 hwndParent, CreationFlags, DeviceInfoData);
1344 MyFree(DeviceNameW);
1345 MyFree(DeviceDescriptionW);
1350 static DWORD SETUPDI_DevNameToDevID(LPCWSTR devName)
1353 int devNameLen = lstrlenW(devName);
1357 TRACE("%s\n", debugstr_w(devName));
1358 for (ptr = devName; valid && *ptr && ptr - devName < devNameLen; )
1363 devInst |= *ptr - '0';
1369 TRACE("%d\n", valid ? devInst : 0xffffffff);
1370 return valid ? devInst : 0xffffffff;
1373 /***********************************************************************
1374 * SetupDiCreateDeviceInfoW (SETUPAPI.@)
1376 BOOL WINAPI SetupDiCreateDeviceInfoW(
1377 HDEVINFO DeviceInfoSet,
1379 CONST GUID *ClassGuid,
1380 PCWSTR DeviceDescription,
1382 DWORD CreationFlags,
1383 PSP_DEVINFO_DATA DeviceInfoData)
1385 struct DeviceInfoSet *set = DeviceInfoSet;
1386 BOOL ret = FALSE, allocatedInstanceId = FALSE;
1387 LPCWSTR instanceId = NULL;
1389 TRACE("%p %s %s %s %p %x %p\n", DeviceInfoSet, debugstr_w(DeviceName),
1390 debugstr_guid(ClassGuid), debugstr_w(DeviceDescription),
1391 hwndParent, CreationFlags, DeviceInfoData);
1395 SetLastError(ERROR_INVALID_DEVINST_NAME);
1398 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
1400 SetLastError(ERROR_INVALID_HANDLE);
1405 SetLastError(ERROR_INVALID_PARAMETER);
1408 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
1410 SetLastError(ERROR_INVALID_HANDLE);
1413 if (!IsEqualGUID(&set->ClassGuid, &GUID_NULL) &&
1414 !IsEqualGUID(ClassGuid, &set->ClassGuid))
1416 SetLastError(ERROR_CLASS_MISMATCH);
1419 if ((CreationFlags & DICD_GENERATE_ID))
1421 if (strchrW(DeviceName, '\\'))
1422 SetLastError(ERROR_INVALID_DEVINST_NAME);
1425 static const WCHAR newDeviceFmt[] = {'R','O','O','T','\\','%','s',
1426 '\\','%','0','4','d',0};
1431 DWORD highestDevID = 0;
1432 struct DeviceInstance *devInst;
1434 LIST_FOR_EACH_ENTRY(devInst, &set->devices, struct DeviceInstance, entry)
1436 struct DeviceInfo *devInfo = (struct DeviceInfo *)devInst->data.Reserved;
1437 LPCWSTR devName = strrchrW(devInfo->instanceId, '\\');
1443 devName = devInfo->instanceId;
1444 id = SETUPDI_DevNameToDevID(devName);
1445 if (id != 0xffffffff && id > highestDevID)
1448 devId = highestDevID + 1;
1452 /* 17 == lstrlenW(L"Root\\") + lstrlenW("\\") + 1 + %d max size */
1453 instanceId = HeapAlloc(GetProcessHeap(), 0,
1454 (17 + lstrlenW(DeviceName)) * sizeof(WCHAR));
1457 sprintfW((LPWSTR)instanceId, newDeviceFmt, DeviceName,
1459 allocatedInstanceId = TRUE;
1468 struct DeviceInstance *devInst;
1471 instanceId = DeviceName;
1472 LIST_FOR_EACH_ENTRY(devInst, &set->devices, struct DeviceInstance, entry)
1474 struct DeviceInfo *devInfo = (struct DeviceInfo *)devInst->data.Reserved;
1476 if (!lstrcmpiW(DeviceName, devInfo->instanceId))
1478 SetLastError(ERROR_DEVINST_ALREADY_EXISTS);
1485 SP_DEVINFO_DATA *dev = NULL;
1487 ret = SETUPDI_AddDeviceToSet(set, ClassGuid, 0 /* FIXME: DevInst */,
1488 instanceId, TRUE, &dev);
1491 if (DeviceDescription)
1492 SetupDiSetDeviceRegistryPropertyW(DeviceInfoSet,
1493 dev, SPDRP_DEVICEDESC, (const BYTE *)DeviceDescription,
1494 lstrlenW(DeviceDescription) * sizeof(WCHAR));
1497 if (DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA))
1499 SetLastError(ERROR_INVALID_USER_BUFFER);
1503 *DeviceInfoData = *dev;
1507 if (allocatedInstanceId)
1508 HeapFree(GetProcessHeap(), 0, (LPWSTR)instanceId);
1513 /***********************************************************************
1514 * SetupDiRegisterDeviceInfo (SETUPAPI.@)
1516 BOOL WINAPI SetupDiRegisterDeviceInfo(
1517 HDEVINFO DeviceInfoSet,
1518 PSP_DEVINFO_DATA DeviceInfoData,
1520 PSP_DETSIG_CMPPROC CompareProc,
1521 PVOID CompareContext,
1522 PSP_DEVINFO_DATA DupDeviceInfoData)
1524 struct DeviceInfoSet *set = DeviceInfoSet;
1525 struct DeviceInfo *devInfo;
1527 TRACE("%p %p %08x %p %p %p\n", DeviceInfoSet, DeviceInfoData, Flags,
1528 CompareProc, CompareContext, DupDeviceInfoData);
1530 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
1532 SetLastError(ERROR_INVALID_HANDLE);
1535 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
1537 SetLastError(ERROR_INVALID_HANDLE);
1540 if (!DeviceInfoData || DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA)
1541 || !DeviceInfoData->Reserved)
1543 SetLastError(ERROR_INVALID_PARAMETER);
1546 devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
1547 if (devInfo->set != set)
1549 SetLastError(ERROR_INVALID_PARAMETER);
1552 if (devInfo->phantom)
1554 devInfo->phantom = FALSE;
1555 RegDeleteValueW(devInfo->key, Phantom);
1560 /***********************************************************************
1561 * SetupDiRemoveDevice (SETUPAPI.@)
1563 BOOL WINAPI SetupDiRemoveDevice(
1565 PSP_DEVINFO_DATA info)
1567 FIXME("(%p, %p): stub\n", devinfo, info);
1568 SetLastError(ERROR_CALL_NOT_IMPLEMENTED);
1572 /***********************************************************************
1573 * SetupDiEnumDeviceInfo (SETUPAPI.@)
1575 BOOL WINAPI SetupDiEnumDeviceInfo(
1578 PSP_DEVINFO_DATA info)
1582 TRACE("%p %d %p\n", devinfo, index, info);
1586 SetLastError(ERROR_INVALID_PARAMETER);
1589 if (devinfo && devinfo != INVALID_HANDLE_VALUE)
1591 struct DeviceInfoSet *list = devinfo;
1592 if (list->magic == SETUP_DEVICE_INFO_SET_MAGIC)
1594 if (index < list->cDevices)
1596 if (info->cbSize == sizeof(SP_DEVINFO_DATA))
1598 struct DeviceInstance *devInst;
1601 LIST_FOR_EACH_ENTRY(devInst, &list->devices,
1602 struct DeviceInstance, entry)
1606 *info = devInst->data;
1613 SetLastError(ERROR_INVALID_USER_BUFFER);
1616 SetLastError(ERROR_NO_MORE_ITEMS);
1619 SetLastError(ERROR_INVALID_HANDLE);
1622 SetLastError(ERROR_INVALID_HANDLE);
1626 /***********************************************************************
1627 * SetupDiGetDeviceInstanceIdA (SETUPAPI.@)
1629 BOOL WINAPI SetupDiGetDeviceInstanceIdA(
1630 HDEVINFO DeviceInfoSet,
1631 PSP_DEVINFO_DATA DeviceInfoData,
1632 PSTR DeviceInstanceId,
1633 DWORD DeviceInstanceIdSize,
1634 PDWORD RequiredSize)
1640 TRACE("%p %p %p %d %p\n", DeviceInfoSet, DeviceInfoData, DeviceInstanceId,
1641 DeviceInstanceIdSize, RequiredSize);
1643 SetupDiGetDeviceInstanceIdW(DeviceInfoSet,
1648 if (GetLastError() != ERROR_INSUFFICIENT_BUFFER)
1650 instanceId = HeapAlloc(GetProcessHeap(), 0, size * sizeof(WCHAR));
1653 ret = SetupDiGetDeviceInstanceIdW(DeviceInfoSet,
1660 int len = WideCharToMultiByte(CP_ACP, 0, instanceId, -1,
1662 DeviceInstanceIdSize, NULL, NULL);
1668 if (len > DeviceInstanceIdSize)
1670 SetLastError(ERROR_INSUFFICIENT_BUFFER);
1674 *RequiredSize = len;
1677 HeapFree(GetProcessHeap(), 0, instanceId);
1682 /***********************************************************************
1683 * SetupDiGetDeviceInstanceIdW (SETUPAPI.@)
1685 BOOL WINAPI SetupDiGetDeviceInstanceIdW(
1686 HDEVINFO DeviceInfoSet,
1687 PSP_DEVINFO_DATA DeviceInfoData,
1688 PWSTR DeviceInstanceId,
1689 DWORD DeviceInstanceIdSize,
1690 PDWORD RequiredSize)
1692 struct DeviceInfoSet *set = DeviceInfoSet;
1693 struct DeviceInfo *devInfo;
1695 TRACE("%p %p %p %d %p\n", DeviceInfoSet, DeviceInfoData, DeviceInstanceId,
1696 DeviceInstanceIdSize, RequiredSize);
1698 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
1700 SetLastError(ERROR_INVALID_HANDLE);
1703 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
1705 SetLastError(ERROR_INVALID_HANDLE);
1708 if (!DeviceInfoData || DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA)
1709 || !DeviceInfoData->Reserved)
1711 SetLastError(ERROR_INVALID_PARAMETER);
1714 devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
1715 if (devInfo->set != set)
1717 SetLastError(ERROR_INVALID_PARAMETER);
1720 TRACE("instance ID: %s\n", debugstr_w(devInfo->instanceId));
1721 if (DeviceInstanceIdSize < strlenW(devInfo->instanceId) + 1)
1723 SetLastError(ERROR_INSUFFICIENT_BUFFER);
1725 *RequiredSize = lstrlenW(devInfo->instanceId) + 1;
1728 lstrcpyW(DeviceInstanceId, devInfo->instanceId);
1730 *RequiredSize = lstrlenW(devInfo->instanceId) + 1;
1734 /***********************************************************************
1735 * SetupDiGetActualSectionToInstallA (SETUPAPI.@)
1737 BOOL WINAPI SetupDiGetActualSectionToInstallA(
1739 PCSTR InfSectionName,
1740 PSTR InfSectionWithExt,
1741 DWORD InfSectionWithExtSize,
1742 PDWORD RequiredSize,
1749 /***********************************************************************
1750 * SetupDiGetActualSectionToInstallW (SETUPAPI.@)
1752 BOOL WINAPI SetupDiGetActualSectionToInstallW(
1754 PCWSTR InfSectionName,
1755 PWSTR InfSectionWithExt,
1756 DWORD InfSectionWithExtSize,
1757 PDWORD RequiredSize,
1760 WCHAR szBuffer[MAX_PATH];
1763 LONG lLineCount = -1;
1765 lstrcpyW(szBuffer, InfSectionName);
1766 dwLength = lstrlenW(szBuffer);
1768 if (OsVersionInfo.dwPlatformId == VER_PLATFORM_WIN32_NT)
1770 /* Test section name with '.NTx86' extension */
1771 lstrcpyW(&szBuffer[dwLength], NtPlatformExtension);
1772 lLineCount = SetupGetLineCountW(InfHandle, szBuffer);
1774 if (lLineCount == -1)
1776 /* Test section name with '.NT' extension */
1777 lstrcpyW(&szBuffer[dwLength], NtExtension);
1778 lLineCount = SetupGetLineCountW(InfHandle, szBuffer);
1783 /* Test section name with '.Win' extension */
1784 lstrcpyW(&szBuffer[dwLength], WinExtension);
1785 lLineCount = SetupGetLineCountW(InfHandle, szBuffer);
1788 if (lLineCount == -1)
1790 /* Test section name without extension */
1791 szBuffer[dwLength] = 0;
1792 lLineCount = SetupGetLineCountW(InfHandle, szBuffer);
1795 if (lLineCount == -1)
1797 SetLastError(ERROR_INVALID_PARAMETER);
1801 dwFullLength = lstrlenW(szBuffer);
1803 if (InfSectionWithExt != NULL && InfSectionWithExtSize != 0)
1805 if (InfSectionWithExtSize < (dwFullLength + 1))
1807 SetLastError(ERROR_INSUFFICIENT_BUFFER);
1811 lstrcpyW(InfSectionWithExt, szBuffer);
1812 if (Extension != NULL)
1814 *Extension = (dwLength == dwFullLength) ? NULL : &InfSectionWithExt[dwLength];
1818 if (RequiredSize != NULL)
1820 *RequiredSize = dwFullLength + 1;
1826 /***********************************************************************
1827 * SetupDiGetClassDescriptionA (SETUPAPI.@)
1829 BOOL WINAPI SetupDiGetClassDescriptionA(
1830 const GUID* ClassGuid,
1831 PSTR ClassDescription,
1832 DWORD ClassDescriptionSize,
1833 PDWORD RequiredSize)
1835 return SetupDiGetClassDescriptionExA(ClassGuid, ClassDescription,
1836 ClassDescriptionSize,
1837 RequiredSize, NULL, NULL);
1840 /***********************************************************************
1841 * SetupDiGetClassDescriptionW (SETUPAPI.@)
1843 BOOL WINAPI SetupDiGetClassDescriptionW(
1844 const GUID* ClassGuid,
1845 PWSTR ClassDescription,
1846 DWORD ClassDescriptionSize,
1847 PDWORD RequiredSize)
1849 return SetupDiGetClassDescriptionExW(ClassGuid, ClassDescription,
1850 ClassDescriptionSize,
1851 RequiredSize, NULL, NULL);
1854 /***********************************************************************
1855 * SetupDiGetClassDescriptionExA (SETUPAPI.@)
1857 BOOL WINAPI SetupDiGetClassDescriptionExA(
1858 const GUID* ClassGuid,
1859 PSTR ClassDescription,
1860 DWORD ClassDescriptionSize,
1861 PDWORD RequiredSize,
1869 hKey = SetupDiOpenClassRegKeyExA(ClassGuid,
1874 if (hKey == INVALID_HANDLE_VALUE)
1876 WARN("SetupDiOpenClassRegKeyExA() failed (Error %u)\n", GetLastError());
1880 dwLength = ClassDescriptionSize;
1881 ret = !RegQueryValueExA( hKey, NULL, NULL, NULL,
1882 (LPBYTE)ClassDescription, &dwLength );
1883 if (RequiredSize) *RequiredSize = dwLength;
1888 /***********************************************************************
1889 * SetupDiGetClassDescriptionExW (SETUPAPI.@)
1891 BOOL WINAPI SetupDiGetClassDescriptionExW(
1892 const GUID* ClassGuid,
1893 PWSTR ClassDescription,
1894 DWORD ClassDescriptionSize,
1895 PDWORD RequiredSize,
1903 hKey = SetupDiOpenClassRegKeyExW(ClassGuid,
1908 if (hKey == INVALID_HANDLE_VALUE)
1910 WARN("SetupDiOpenClassRegKeyExW() failed (Error %u)\n", GetLastError());
1914 dwLength = ClassDescriptionSize * sizeof(WCHAR);
1915 ret = !RegQueryValueExW( hKey, NULL, NULL, NULL,
1916 (LPBYTE)ClassDescription, &dwLength );
1917 if (RequiredSize) *RequiredSize = dwLength / sizeof(WCHAR);
1922 /***********************************************************************
1923 * SetupDiGetClassDevsA (SETUPAPI.@)
1925 HDEVINFO WINAPI SetupDiGetClassDevsA(
1932 LPWSTR enumstrW = NULL;
1936 int len = MultiByteToWideChar(CP_ACP, 0, enumstr, -1, NULL, 0);
1937 enumstrW = HeapAlloc(GetProcessHeap(), 0, len * sizeof(WCHAR));
1940 ret = INVALID_HANDLE_VALUE;
1943 MultiByteToWideChar(CP_ACP, 0, enumstr, -1, enumstrW, len);
1945 ret = SetupDiGetClassDevsExW(class, enumstrW, parent, flags, NULL, NULL,
1947 HeapFree(GetProcessHeap(), 0, enumstrW);
1953 /***********************************************************************
1954 * SetupDiGetClassDevsExA (SETUPAPI.@)
1956 HDEVINFO WINAPI SetupDiGetClassDevsExA(
1966 LPWSTR enumstrW = NULL, machineW = NULL;
1970 int len = MultiByteToWideChar(CP_ACP, 0, enumstr, -1, NULL, 0);
1971 enumstrW = HeapAlloc(GetProcessHeap(), 0, len * sizeof(WCHAR));
1974 ret = INVALID_HANDLE_VALUE;
1977 MultiByteToWideChar(CP_ACP, 0, enumstr, -1, enumstrW, len);
1981 int len = MultiByteToWideChar(CP_ACP, 0, machine, -1, NULL, 0);
1982 machineW = HeapAlloc(GetProcessHeap(), 0, len * sizeof(WCHAR));
1985 HeapFree(GetProcessHeap(), 0, enumstrW);
1986 ret = INVALID_HANDLE_VALUE;
1989 MultiByteToWideChar(CP_ACP, 0, machine, -1, machineW, len);
1991 ret = SetupDiGetClassDevsExW(class, enumstrW, parent, flags, deviceset,
1992 machineW, reserved);
1993 HeapFree(GetProcessHeap(), 0, enumstrW);
1994 HeapFree(GetProcessHeap(), 0, machineW);
2000 static void SETUPDI_AddDeviceInterfaces(SP_DEVINFO_DATA *dev, HKEY key,
2004 WCHAR subKeyName[MAX_PATH];
2005 LONG l = ERROR_SUCCESS;
2007 for (i = 0; !l; i++)
2009 len = sizeof(subKeyName) / sizeof(subKeyName[0]);
2010 l = RegEnumKeyExW(key, i, subKeyName, &len, NULL, NULL, NULL, NULL);
2014 SP_DEVICE_INTERFACE_DATA *iface = NULL;
2016 if (*subKeyName == '#')
2018 /* The subkey name is the reference string, with a '#' prepended */
2019 SETUPDI_AddInterfaceInstance(dev, guid, subKeyName + 1, &iface);
2020 l = RegOpenKeyExW(key, subKeyName, 0, KEY_READ, &subKey);
2023 WCHAR symbolicLink[MAX_PATH];
2026 len = sizeof(symbolicLink);
2027 l = RegQueryValueExW(subKey, SymbolicLink, NULL, &dataType,
2028 (BYTE *)symbolicLink, &len);
2029 if (!l && dataType == REG_SZ)
2030 SETUPDI_SetInterfaceSymbolicLink(iface, symbolicLink);
2031 RegCloseKey(subKey);
2034 /* Allow enumeration to continue */
2038 /* FIXME: find and add all the device's interfaces to the device */
2041 static void SETUPDI_EnumerateMatchingInterfaces(HDEVINFO DeviceInfoSet,
2042 HKEY key, const GUID *guid, LPCWSTR enumstr)
2044 struct DeviceInfoSet *set = DeviceInfoSet;
2046 WCHAR subKeyName[MAX_PATH];
2048 HKEY enumKey = INVALID_HANDLE_VALUE;
2050 TRACE("%s\n", debugstr_w(enumstr));
2052 l = RegCreateKeyExW(HKEY_LOCAL_MACHINE, Enum, 0, NULL, 0, KEY_READ, NULL,
2054 for (i = 0; !l; i++)
2056 len = sizeof(subKeyName) / sizeof(subKeyName[0]);
2057 l = RegEnumKeyExW(key, i, subKeyName, &len, NULL, NULL, NULL, NULL);
2062 l = RegOpenKeyExW(key, subKeyName, 0, KEY_READ, &subKey);
2065 WCHAR deviceInst[MAX_PATH * 3];
2068 len = sizeof(deviceInst);
2069 l = RegQueryValueExW(subKey, DeviceInstance, NULL, &dataType,
2070 (BYTE *)deviceInst, &len);
2071 if (!l && dataType == REG_SZ)
2073 TRACE("found instance ID %s\n", debugstr_w(deviceInst));
2074 if (!enumstr || !lstrcmpiW(enumstr, deviceInst))
2078 l = RegOpenKeyExW(enumKey, deviceInst, 0, KEY_READ,
2082 WCHAR deviceClassStr[40];
2084 len = sizeof(deviceClassStr);
2085 l = RegQueryValueExW(deviceKey, ClassGUID, NULL,
2086 &dataType, (BYTE *)deviceClassStr, &len);
2087 if (!l && dataType == REG_SZ &&
2088 deviceClassStr[0] == '{' &&
2089 deviceClassStr[37] == '}')
2092 SP_DEVINFO_DATA *dev;
2094 deviceClassStr[37] = 0;
2095 UuidFromStringW(&deviceClassStr[1],
2097 if (SETUPDI_AddDeviceToSet(set, &deviceClass,
2098 0 /* FIXME: DevInst */, deviceInst,
2100 SETUPDI_AddDeviceInterfaces(dev, subKey, guid);
2102 RegCloseKey(deviceKey);
2106 RegCloseKey(subKey);
2108 /* Allow enumeration to continue */
2112 if (enumKey != INVALID_HANDLE_VALUE)
2113 RegCloseKey(enumKey);
2116 static void SETUPDI_EnumerateInterfaces(HDEVINFO DeviceInfoSet,
2117 const GUID *guid, LPCWSTR enumstr, DWORD flags)
2119 HKEY interfacesKey = SetupDiOpenClassRegKeyExW(guid, KEY_READ,
2120 DIOCR_INTERFACE, NULL, NULL);
2122 TRACE("%p, %s, %s, %08x\n", DeviceInfoSet, debugstr_guid(guid),
2123 debugstr_w(enumstr), flags);
2125 if (interfacesKey != INVALID_HANDLE_VALUE)
2127 if (flags & DIGCF_ALLCLASSES)
2130 WCHAR interfaceGuidStr[40];
2131 LONG l = ERROR_SUCCESS;
2133 for (i = 0; !l; i++)
2135 len = sizeof(interfaceGuidStr) / sizeof(interfaceGuidStr[0]);
2136 l = RegEnumKeyExW(interfacesKey, i, interfaceGuidStr, &len,
2137 NULL, NULL, NULL, NULL);
2140 if (interfaceGuidStr[0] == '{' &&
2141 interfaceGuidStr[37] == '}')
2146 interfaceGuidStr[37] = 0;
2147 UuidFromStringW(&interfaceGuidStr[1], &interfaceGuid);
2148 l = RegOpenKeyExW(interfacesKey, interfaceGuidStr, 0,
2149 KEY_READ, &interfaceKey);
2152 SETUPDI_EnumerateMatchingInterfaces(DeviceInfoSet,
2153 interfaceKey, &interfaceGuid, enumstr);
2154 RegCloseKey(interfaceKey);
2162 /* In this case, SetupDiOpenClassRegKeyExW opened the specific
2163 * interface's key, so just pass that long
2165 SETUPDI_EnumerateMatchingInterfaces(DeviceInfoSet,
2166 interfacesKey, guid, enumstr);
2168 RegCloseKey(interfacesKey);
2172 static void SETUPDI_EnumerateMatchingDeviceInstances(struct DeviceInfoSet *set,
2173 LPCWSTR enumerator, LPCWSTR deviceName, HKEY deviceKey,
2174 const GUID *class, DWORD flags)
2177 WCHAR deviceInstance[MAX_PATH];
2178 LONG l = ERROR_SUCCESS;
2180 TRACE("%s %s\n", debugstr_w(enumerator), debugstr_w(deviceName));
2182 for (i = 0; !l; i++)
2184 len = sizeof(deviceInstance) / sizeof(deviceInstance[0]);
2185 l = RegEnumKeyExW(deviceKey, i, deviceInstance, &len, NULL, NULL, NULL,
2191 l = RegOpenKeyExW(deviceKey, deviceInstance, 0, KEY_READ, &subKey);
2194 WCHAR classGuid[40];
2197 len = sizeof(classGuid);
2198 l = RegQueryValueExW(subKey, ClassGUID, NULL, &dataType,
2199 (BYTE *)classGuid, &len);
2200 if (!l && dataType == REG_SZ)
2202 if (classGuid[0] == '{' && classGuid[37] == '}')
2207 UuidFromStringW(&classGuid[1], &deviceClass);
2208 if ((flags & DIGCF_ALLCLASSES) ||
2209 IsEqualGUID(class, &deviceClass))
2211 static const WCHAR fmt[] =
2212 {'%','s','\\','%','s','\\','%','s',0};
2215 instanceId = HeapAlloc(GetProcessHeap(), 0,
2216 (lstrlenW(enumerator) + lstrlenW(deviceName) +
2217 lstrlenW(deviceInstance) + 3) * sizeof(WCHAR));
2220 sprintfW(instanceId, fmt, enumerator,
2221 deviceName, deviceInstance);
2222 SETUPDI_AddDeviceToSet(set, &deviceClass,
2223 0 /* FIXME: DevInst */, instanceId,
2225 HeapFree(GetProcessHeap(), 0, instanceId);
2230 RegCloseKey(subKey);
2232 /* Allow enumeration to continue */
2238 static void SETUPDI_EnumerateMatchingDevices(HDEVINFO DeviceInfoSet,
2239 LPCWSTR parent, HKEY key, const GUID *class, DWORD flags)
2241 struct DeviceInfoSet *set = DeviceInfoSet;
2243 WCHAR subKeyName[MAX_PATH];
2244 LONG l = ERROR_SUCCESS;
2246 TRACE("%s\n", debugstr_w(parent));
2248 for (i = 0; !l; i++)
2250 len = sizeof(subKeyName) / sizeof(subKeyName[0]);
2251 l = RegEnumKeyExW(key, i, subKeyName, &len, NULL, NULL, NULL, NULL);
2256 l = RegOpenKeyExW(key, subKeyName, 0, KEY_READ, &subKey);
2259 TRACE("%s\n", debugstr_w(subKeyName));
2260 SETUPDI_EnumerateMatchingDeviceInstances(set, parent,
2261 subKeyName, subKey, class, flags);
2262 RegCloseKey(subKey);
2264 /* Allow enumeration to continue */
2270 static void SETUPDI_EnumerateDevices(HDEVINFO DeviceInfoSet, const GUID *class,
2271 LPCWSTR enumstr, DWORD flags)
2276 TRACE("%p, %s, %s, %08x\n", DeviceInfoSet, debugstr_guid(class),
2277 debugstr_w(enumstr), flags);
2279 l = RegCreateKeyExW(HKEY_LOCAL_MACHINE, Enum, 0, NULL, 0, KEY_READ, NULL,
2281 if (enumKey != INVALID_HANDLE_VALUE)
2287 l = RegOpenKeyExW(enumKey, enumstr, 0, KEY_READ,
2291 SETUPDI_EnumerateMatchingDevices(DeviceInfoSet, enumstr,
2292 enumStrKey, class, flags);
2293 RegCloseKey(enumStrKey);
2299 WCHAR subKeyName[MAX_PATH];
2302 for (i = 0; !l; i++)
2304 len = sizeof(subKeyName) / sizeof(subKeyName[0]);
2305 l = RegEnumKeyExW(enumKey, i, subKeyName, &len, NULL,
2311 l = RegOpenKeyExW(enumKey, subKeyName, 0, KEY_READ,
2315 SETUPDI_EnumerateMatchingDevices(DeviceInfoSet,
2316 subKeyName, subKey, class, flags);
2317 RegCloseKey(subKey);
2319 /* Allow enumeration to continue */
2324 RegCloseKey(enumKey);
2328 /***********************************************************************
2329 * SetupDiGetClassDevsW (SETUPAPI.@)
2331 HDEVINFO WINAPI SetupDiGetClassDevsW(
2337 return SetupDiGetClassDevsExW(class, enumstr, parent, flags, NULL, NULL,
2341 /***********************************************************************
2342 * SetupDiGetClassDevsExW (SETUPAPI.@)
2344 HDEVINFO WINAPI SetupDiGetClassDevsExW(
2353 static const DWORD unsupportedFlags = DIGCF_DEFAULT | DIGCF_PRESENT |
2357 TRACE("%s %s %p 0x%08x %p %s %p\n", debugstr_guid(class),
2358 debugstr_w(enumstr), parent, flags, deviceset, debugstr_w(machine),
2361 if (!(flags & DIGCF_ALLCLASSES) && !class)
2363 SetLastError(ERROR_INVALID_PARAMETER);
2366 if (flags & unsupportedFlags)
2367 WARN("unsupported flags %08x\n", flags & unsupportedFlags);
2371 set = SetupDiCreateDeviceInfoListExW(class, parent, machine, reserved);
2374 if (machine && *machine)
2375 FIXME("%s: unimplemented for remote machines\n",
2376 debugstr_w(machine));
2377 else if (flags & DIGCF_DEVICEINTERFACE)
2378 SETUPDI_EnumerateInterfaces(set, class, enumstr, flags);
2380 SETUPDI_EnumerateDevices(set, class, enumstr, flags);
2385 /***********************************************************************
2386 * SetupDiGetDeviceInfoListDetailA (SETUPAPI.@)
2388 BOOL WINAPI SetupDiGetDeviceInfoListDetailA(
2389 HDEVINFO DeviceInfoSet,
2390 PSP_DEVINFO_LIST_DETAIL_DATA_A DevInfoData )
2392 struct DeviceInfoSet *set = DeviceInfoSet;
2394 TRACE("%p %p\n", DeviceInfoSet, DevInfoData);
2396 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
2398 SetLastError(ERROR_INVALID_HANDLE);
2401 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
2403 SetLastError(ERROR_INVALID_HANDLE);
2407 DevInfoData->cbSize != sizeof(SP_DEVINFO_LIST_DETAIL_DATA_A))
2409 SetLastError(ERROR_INVALID_PARAMETER);
2412 DevInfoData->ClassGuid = set->ClassGuid;
2413 DevInfoData->RemoteMachineHandle = NULL;
2414 DevInfoData->RemoteMachineName[0] = '\0';
2418 /***********************************************************************
2419 * SetupDiGetDeviceInfoListDetailW (SETUPAPI.@)
2421 BOOL WINAPI SetupDiGetDeviceInfoListDetailW(
2422 HDEVINFO DeviceInfoSet,
2423 PSP_DEVINFO_LIST_DETAIL_DATA_W DevInfoData )
2425 struct DeviceInfoSet *set = DeviceInfoSet;
2427 TRACE("%p %p\n", DeviceInfoSet, DevInfoData);
2429 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
2431 SetLastError(ERROR_INVALID_HANDLE);
2434 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
2436 SetLastError(ERROR_INVALID_HANDLE);
2440 DevInfoData->cbSize != sizeof(SP_DEVINFO_LIST_DETAIL_DATA_W))
2442 SetLastError(ERROR_INVALID_PARAMETER);
2445 DevInfoData->ClassGuid = set->ClassGuid;
2446 DevInfoData->RemoteMachineHandle = NULL;
2447 DevInfoData->RemoteMachineName[0] = '\0';
2451 /***********************************************************************
2452 * SetupDiCreateDeviceInterfaceA (SETUPAPI.@)
2454 BOOL WINAPI SetupDiCreateDeviceInterfaceA(
2455 HDEVINFO DeviceInfoSet,
2456 PSP_DEVINFO_DATA DeviceInfoData,
2457 const GUID *InterfaceClassGuid,
2458 PCSTR ReferenceString,
2459 DWORD CreationFlags,
2460 PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData)
2463 LPWSTR ReferenceStringW = NULL;
2465 TRACE("%p %p %s %s %08x %p\n", DeviceInfoSet, DeviceInfoData,
2466 debugstr_guid(InterfaceClassGuid), debugstr_a(ReferenceString),
2467 CreationFlags, DeviceInterfaceData);
2469 if (ReferenceString)
2471 ReferenceStringW = MultiByteToUnicode(ReferenceString, CP_ACP);
2472 if (ReferenceStringW == NULL) return FALSE;
2475 ret = SetupDiCreateDeviceInterfaceW(DeviceInfoSet, DeviceInfoData,
2476 InterfaceClassGuid, ReferenceStringW, CreationFlags,
2477 DeviceInterfaceData);
2479 MyFree(ReferenceStringW);
2484 /***********************************************************************
2485 * SetupDiCreateDeviceInterfaceW (SETUPAPI.@)
2487 BOOL WINAPI SetupDiCreateDeviceInterfaceW(
2488 HDEVINFO DeviceInfoSet,
2489 PSP_DEVINFO_DATA DeviceInfoData,
2490 const GUID *InterfaceClassGuid,
2491 PCWSTR ReferenceString,
2492 DWORD CreationFlags,
2493 PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData)
2495 struct DeviceInfoSet *set = DeviceInfoSet;
2496 struct DeviceInfo *devInfo;
2497 SP_DEVICE_INTERFACE_DATA *iface = NULL;
2500 TRACE("%p %p %s %s %08x %p\n", DeviceInfoSet, DeviceInfoData,
2501 debugstr_guid(InterfaceClassGuid), debugstr_w(ReferenceString),
2502 CreationFlags, DeviceInterfaceData);
2504 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
2506 SetLastError(ERROR_INVALID_HANDLE);
2509 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
2511 SetLastError(ERROR_INVALID_HANDLE);
2514 if (!DeviceInfoData || DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA)
2515 || !DeviceInfoData->Reserved)
2517 SetLastError(ERROR_INVALID_PARAMETER);
2520 devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
2521 if (devInfo->set != set)
2523 SetLastError(ERROR_INVALID_PARAMETER);
2526 if (!InterfaceClassGuid)
2528 SetLastError(ERROR_INVALID_USER_BUFFER);
2531 if ((ret = SETUPDI_AddInterfaceInstance(DeviceInfoData, InterfaceClassGuid,
2532 ReferenceString, &iface)))
2534 if (DeviceInterfaceData)
2536 if (DeviceInterfaceData->cbSize != sizeof(SP_DEVICE_INTERFACE_DATA))
2538 SetLastError(ERROR_INVALID_USER_BUFFER);
2542 *DeviceInterfaceData = *iface;
2548 /***********************************************************************
2549 * SetupDiCreateDeviceInterfaceRegKeyA (SETUPAPI.@)
2551 HKEY WINAPI SetupDiCreateDeviceInterfaceRegKeyA(
2552 HDEVINFO DeviceInfoSet,
2553 PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
2557 PCSTR InfSectionName)
2560 PWSTR InfSectionNameW = NULL;
2562 TRACE("%p %p %d %08x %p %p\n", DeviceInfoSet, DeviceInterfaceData, Reserved,
2563 samDesired, InfHandle, InfSectionName);
2566 if (!InfSectionName)
2568 SetLastError(ERROR_INVALID_PARAMETER);
2569 return INVALID_HANDLE_VALUE;
2571 InfSectionNameW = MultiByteToUnicode(InfSectionName, CP_ACP);
2572 if (!InfSectionNameW)
2573 return INVALID_HANDLE_VALUE;
2575 key = SetupDiCreateDeviceInterfaceRegKeyW(DeviceInfoSet,
2576 DeviceInterfaceData, Reserved, samDesired, InfHandle,
2578 MyFree(InfSectionNameW);
2582 static PWSTR SETUPDI_GetInstancePath(struct InterfaceInfo *ifaceInfo)
2584 static const WCHAR hash[] = {'#',0};
2585 PWSTR instancePath = NULL;
2587 if (ifaceInfo->referenceString)
2589 instancePath = HeapAlloc(GetProcessHeap(), 0,
2590 (lstrlenW(ifaceInfo->referenceString) + 2) * sizeof(WCHAR));
2593 lstrcpyW(instancePath, hash);
2594 lstrcatW(instancePath, ifaceInfo->referenceString);
2597 SetLastError(ERROR_OUTOFMEMORY);
2601 instancePath = HeapAlloc(GetProcessHeap(), 0,
2602 (lstrlenW(hash) + 1) * sizeof(WCHAR));
2604 lstrcpyW(instancePath, hash);
2606 return instancePath;
2609 /***********************************************************************
2610 * SetupDiCreateDeviceInterfaceRegKeyW (SETUPAPI.@)
2612 HKEY WINAPI SetupDiCreateDeviceInterfaceRegKeyW(
2613 HDEVINFO DeviceInfoSet,
2614 PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
2618 PCWSTR InfSectionName)
2620 struct DeviceInfoSet *set = DeviceInfoSet;
2621 HKEY key = INVALID_HANDLE_VALUE, interfacesKey;
2624 TRACE("%p %p %d %08x %p %p\n", DeviceInfoSet, DeviceInterfaceData, Reserved,
2625 samDesired, InfHandle, InfSectionName);
2627 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE ||
2628 set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
2630 SetLastError(ERROR_INVALID_HANDLE);
2631 return INVALID_HANDLE_VALUE;
2633 if (!DeviceInterfaceData ||
2634 DeviceInterfaceData->cbSize != sizeof(SP_DEVICE_INTERFACE_DATA) ||
2635 !DeviceInterfaceData->Reserved)
2637 SetLastError(ERROR_INVALID_PARAMETER);
2638 return INVALID_HANDLE_VALUE;
2640 if (InfHandle && !InfSectionName)
2642 SetLastError(ERROR_INVALID_PARAMETER);
2643 return INVALID_HANDLE_VALUE;
2645 if (!(l = RegCreateKeyExW(HKEY_LOCAL_MACHINE, DeviceClasses, 0, NULL, 0,
2646 samDesired, NULL, &interfacesKey, NULL)))
2649 WCHAR bracedGuidString[39];
2651 SETUPDI_GuidToString(&DeviceInterfaceData->InterfaceClassGuid,
2653 if (!(l = RegCreateKeyExW(interfacesKey, bracedGuidString, 0, NULL, 0,
2654 samDesired, NULL, &parent, NULL)))
2656 struct InterfaceInfo *ifaceInfo =
2657 (struct InterfaceInfo *)DeviceInterfaceData->Reserved;
2658 PWSTR instancePath = SETUPDI_GetInstancePath(ifaceInfo);
2659 PWSTR interfKeyName = HeapAlloc(GetProcessHeap(), 0,
2660 (lstrlenW(ifaceInfo->symbolicLink) + 1) * sizeof(WCHAR));
2664 lstrcpyW(interfKeyName, ifaceInfo->symbolicLink);
2665 if (lstrlenW(ifaceInfo->symbolicLink) > 3)
2667 interfKeyName[0] = '#';
2668 interfKeyName[1] = '#';
2669 interfKeyName[3] = '#';
2671 ptr = strchrW(interfKeyName, '\\');
2674 l = RegCreateKeyExW(parent, interfKeyName, 0, NULL, 0,
2675 samDesired, NULL, &interfKey, NULL);
2678 struct DeviceInfo *devInfo =
2679 (struct DeviceInfo *)ifaceInfo->device->Reserved;
2681 l = RegSetValueExW(interfKey, DeviceInstance, 0, REG_SZ,
2682 (BYTE *)devInfo->instanceId,
2683 (lstrlenW(devInfo->instanceId) + 1) * sizeof(WCHAR));
2690 l = RegCreateKeyExW(interfKey, instancePath, 0, NULL, 0,
2691 samDesired, NULL, &key, NULL);
2695 key = INVALID_HANDLE_VALUE;
2698 FIXME("INF section installation unsupported\n");
2703 RegCloseKey(interfKey);
2707 HeapFree(GetProcessHeap(), 0, interfKeyName);
2708 HeapFree(GetProcessHeap(), 0, instancePath);
2709 RegCloseKey(parent);
2713 RegCloseKey(interfacesKey);
2720 /***********************************************************************
2721 * SetupDiDeleteDeviceInterfaceRegKey (SETUPAPI.@)
2723 BOOL WINAPI SetupDiDeleteDeviceInterfaceRegKey(
2724 HDEVINFO DeviceInfoSet,
2725 PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
2728 struct DeviceInfoSet *set = DeviceInfoSet;
2732 TRACE("%p %p %d\n", DeviceInfoSet, DeviceInterfaceData, Reserved);
2734 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE ||
2735 set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
2737 SetLastError(ERROR_INVALID_HANDLE);
2740 if (!DeviceInterfaceData ||
2741 DeviceInterfaceData->cbSize != sizeof(SP_DEVICE_INTERFACE_DATA) ||
2742 !DeviceInterfaceData->Reserved)
2744 SetLastError(ERROR_INVALID_PARAMETER);
2747 parent = SetupDiOpenClassRegKeyExW(&DeviceInterfaceData->InterfaceClassGuid,
2748 KEY_ALL_ACCESS, DIOCR_INTERFACE, NULL, NULL);
2749 if (parent != INVALID_HANDLE_VALUE)
2751 struct InterfaceInfo *ifaceInfo =
2752 (struct InterfaceInfo *)DeviceInterfaceData->Reserved;
2753 PWSTR instancePath = SETUPDI_GetInstancePath(ifaceInfo);
2757 LONG l = RegDeleteKeyW(parent, instancePath);
2763 HeapFree(GetProcessHeap(), 0, instancePath);
2765 RegCloseKey(parent);
2770 /***********************************************************************
2771 * SetupDiEnumDeviceInterfaces (SETUPAPI.@)
2774 * DeviceInfoSet [I] Set of devices from which to enumerate
2776 * DeviceInfoData [I] (Optional) If specified, a specific device
2777 * instance from which to enumerate interfaces.
2778 * If it isn't specified, all interfaces for all
2779 * devices in the set are enumerated.
2780 * InterfaceClassGuid [I] The interface class to enumerate.
2781 * MemberIndex [I] An index of the interface instance to enumerate.
2782 * A caller should start with MemberIndex set to 0,
2783 * and continue until the function fails with
2784 * ERROR_NO_MORE_ITEMS.
2785 * DeviceInterfaceData [I/O] Returns an enumerated interface. Its cbSize
2786 * member must be set to
2787 * sizeof(SP_DEVICE_INTERFACE_DATA).
2790 * Success: non-zero value.
2791 * Failure: FALSE. Call GetLastError() for more info.
2793 BOOL WINAPI SetupDiEnumDeviceInterfaces(
2794 HDEVINFO DeviceInfoSet,
2795 PSP_DEVINFO_DATA DeviceInfoData,
2796 CONST GUID * InterfaceClassGuid,
2798 PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData)
2800 struct DeviceInfoSet *set = DeviceInfoSet;
2803 TRACE("%p, %p, %s, %d, %p\n", DeviceInfoSet, DeviceInfoData,
2804 debugstr_guid(InterfaceClassGuid), MemberIndex, DeviceInterfaceData);
2806 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE ||
2807 set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
2809 SetLastError(ERROR_INVALID_HANDLE);
2812 if (DeviceInfoData && (DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA) ||
2813 !DeviceInfoData->Reserved))
2815 SetLastError(ERROR_INVALID_PARAMETER);
2818 if (!DeviceInterfaceData ||
2819 DeviceInterfaceData->cbSize != sizeof(SP_DEVICE_INTERFACE_DATA))
2821 SetLastError(ERROR_INVALID_PARAMETER);
2824 /* In case application fails to check return value, clear output */
2825 memset(DeviceInterfaceData, 0, sizeof(*DeviceInterfaceData));
2828 struct DeviceInfo *devInfo =
2829 (struct DeviceInfo *)DeviceInfoData->Reserved;
2830 struct InterfaceInstances *iface;
2832 if ((ret = SETUPDI_FindInterface(devInfo, InterfaceClassGuid, &iface)))
2834 if (MemberIndex < iface->cInstances)
2835 *DeviceInterfaceData = iface->instances[MemberIndex];
2838 SetLastError(ERROR_NO_MORE_ITEMS);
2843 SetLastError(ERROR_NO_MORE_ITEMS);
2847 struct DeviceInstance *devInst;
2848 DWORD cEnumerated = 0;
2851 LIST_FOR_EACH_ENTRY(devInst, &set->devices, struct DeviceInstance, entry)
2853 struct DeviceInfo *devInfo = (struct DeviceInfo *)devInst->data.Reserved;
2854 struct InterfaceInstances *iface;
2856 if (found || cEnumerated >= MemberIndex + 1)
2858 if (SETUPDI_FindInterface(devInfo, InterfaceClassGuid, &iface))
2860 if (cEnumerated + iface->cInstances < MemberIndex + 1)
2861 cEnumerated += iface->cInstances;
2864 DWORD instanceIndex = MemberIndex - cEnumerated;
2866 *DeviceInterfaceData = iface->instances[instanceIndex];
2867 cEnumerated += instanceIndex + 1;
2874 SetLastError(ERROR_NO_MORE_ITEMS);
2879 /***********************************************************************
2880 * SetupDiDestroyDeviceInfoList (SETUPAPI.@)
2882 * Destroy a DeviceInfoList and free all used memory of the list.
2885 * devinfo [I] DeviceInfoList pointer to list to destroy
2888 * Success: non zero value.
2889 * Failure: zero value.
2891 BOOL WINAPI SetupDiDestroyDeviceInfoList(HDEVINFO devinfo)
2895 TRACE("%p\n", devinfo);
2896 if (devinfo && devinfo != INVALID_HANDLE_VALUE)
2898 struct DeviceInfoSet *list = devinfo;
2900 if (list->magic == SETUP_DEVICE_INFO_SET_MAGIC)
2902 struct DeviceInstance *devInst, *devInst2;
2904 LIST_FOR_EACH_ENTRY_SAFE(devInst, devInst2, &list->devices,
2905 struct DeviceInstance, entry)
2907 SETUPDI_FreeDeviceInfo( (struct DeviceInfo *)devInst->data.Reserved );
2908 list_remove(&devInst->entry);
2909 HeapFree(GetProcessHeap(), 0, devInst);
2911 HeapFree(GetProcessHeap(), 0, list);
2917 SetLastError(ERROR_INVALID_HANDLE);
2922 /***********************************************************************
2923 * SetupDiGetDeviceInterfaceDetailA (SETUPAPI.@)
2925 BOOL WINAPI SetupDiGetDeviceInterfaceDetailA(
2926 HDEVINFO DeviceInfoSet,
2927 PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
2928 PSP_DEVICE_INTERFACE_DETAIL_DATA_A DeviceInterfaceDetailData,
2929 DWORD DeviceInterfaceDetailDataSize,
2930 PDWORD RequiredSize,
2931 PSP_DEVINFO_DATA DeviceInfoData)
2933 struct DeviceInfoSet *set = DeviceInfoSet;
2934 struct InterfaceInfo *info;
2935 DWORD bytesNeeded = FIELD_OFFSET(SP_DEVICE_INTERFACE_DETAIL_DATA_A, DevicePath[1]);
2938 TRACE("(%p, %p, %p, %d, %p, %p)\n", DeviceInfoSet,
2939 DeviceInterfaceData, DeviceInterfaceDetailData,
2940 DeviceInterfaceDetailDataSize, RequiredSize, DeviceInfoData);
2942 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE ||
2943 set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
2945 SetLastError(ERROR_INVALID_HANDLE);
2948 if (!DeviceInterfaceData ||
2949 DeviceInterfaceData->cbSize != sizeof(SP_DEVICE_INTERFACE_DATA) ||
2950 !DeviceInterfaceData->Reserved)
2952 SetLastError(ERROR_INVALID_PARAMETER);
2955 if (DeviceInterfaceDetailData &&
2956 DeviceInterfaceDetailData->cbSize != sizeof(SP_DEVICE_INTERFACE_DETAIL_DATA_A))
2958 SetLastError(ERROR_INVALID_USER_BUFFER);
2961 if (!DeviceInterfaceDetailData && DeviceInterfaceDetailDataSize)
2963 SetLastError(ERROR_INVALID_USER_BUFFER);
2966 info = (struct InterfaceInfo *)DeviceInterfaceData->Reserved;
2967 if (info->symbolicLink)
2968 bytesNeeded += WideCharToMultiByte(CP_ACP, 0, info->symbolicLink, -1,
2969 NULL, 0, NULL, NULL);
2970 if (DeviceInterfaceDetailDataSize >= bytesNeeded)
2972 if (info->symbolicLink)
2973 WideCharToMultiByte(CP_ACP, 0, info->symbolicLink, -1,
2974 DeviceInterfaceDetailData->DevicePath,
2975 DeviceInterfaceDetailDataSize -
2976 offsetof(SP_DEVICE_INTERFACE_DETAIL_DATA_A, DevicePath),
2979 DeviceInterfaceDetailData->DevicePath[0] = '\0';
2980 if (DeviceInfoData && DeviceInfoData->cbSize == sizeof(SP_DEVINFO_DATA))
2981 *DeviceInfoData = *info->device;
2987 *RequiredSize = bytesNeeded;
2988 SetLastError(ERROR_INSUFFICIENT_BUFFER);
2993 /***********************************************************************
2994 * SetupDiGetDeviceInterfaceDetailW (SETUPAPI.@)
2996 BOOL WINAPI SetupDiGetDeviceInterfaceDetailW(
2997 HDEVINFO DeviceInfoSet,
2998 PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
2999 PSP_DEVICE_INTERFACE_DETAIL_DATA_W DeviceInterfaceDetailData,
3000 DWORD DeviceInterfaceDetailDataSize,
3001 PDWORD RequiredSize,
3002 PSP_DEVINFO_DATA DeviceInfoData)
3004 struct DeviceInfoSet *set = DeviceInfoSet;
3005 struct InterfaceInfo *info;
3006 DWORD bytesNeeded = offsetof(SP_DEVICE_INTERFACE_DETAIL_DATA_W, DevicePath)
3007 + sizeof(WCHAR); /* include NULL terminator */
3010 TRACE("(%p, %p, %p, %d, %p, %p)\n", DeviceInfoSet,
3011 DeviceInterfaceData, DeviceInterfaceDetailData,
3012 DeviceInterfaceDetailDataSize, RequiredSize, DeviceInfoData);
3014 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE ||
3015 set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
3017 SetLastError(ERROR_INVALID_HANDLE);
3020 if (!DeviceInterfaceData ||
3021 DeviceInterfaceData->cbSize != sizeof(SP_DEVICE_INTERFACE_DATA) ||
3022 !DeviceInterfaceData->Reserved)
3024 SetLastError(ERROR_INVALID_PARAMETER);
3027 if (DeviceInterfaceDetailData && (DeviceInterfaceDetailData->cbSize <
3028 offsetof(SP_DEVICE_INTERFACE_DETAIL_DATA_W, DevicePath) + sizeof(WCHAR) ||
3029 DeviceInterfaceDetailData->cbSize > sizeof(SP_DEVICE_INTERFACE_DETAIL_DATA_W)))
3031 SetLastError(ERROR_INVALID_USER_BUFFER);
3034 if (!DeviceInterfaceDetailData && DeviceInterfaceDetailDataSize)
3036 SetLastError(ERROR_INVALID_USER_BUFFER);
3039 info = (struct InterfaceInfo *)DeviceInterfaceData->Reserved;
3040 if (info->symbolicLink)
3041 bytesNeeded += sizeof(WCHAR)*lstrlenW(info->symbolicLink);
3042 if (DeviceInterfaceDetailDataSize >= bytesNeeded)
3044 if (info->symbolicLink)
3045 lstrcpyW(DeviceInterfaceDetailData->DevicePath, info->symbolicLink);
3047 DeviceInterfaceDetailData->DevicePath[0] = '\0';
3048 if (DeviceInfoData && DeviceInfoData->cbSize == sizeof(SP_DEVINFO_DATA))
3049 *DeviceInfoData = *info->device;
3055 *RequiredSize = bytesNeeded;
3056 SetLastError(ERROR_INSUFFICIENT_BUFFER);
3061 struct PropertyMapEntry
3068 static const struct PropertyMapEntry PropertyMap[] = {
3069 { REG_SZ, "DeviceDesc", DeviceDesc },
3070 { REG_MULTI_SZ, "HardwareId", HardwareId },
3071 { REG_MULTI_SZ, "CompatibleIDs", CompatibleIDs },
3072 { 0, NULL, NULL }, /* SPDRP_UNUSED0 */
3073 { REG_SZ, "Service", Service },
3074 { 0, NULL, NULL }, /* SPDRP_UNUSED1 */
3075 { 0, NULL, NULL }, /* SPDRP_UNUSED2 */
3076 { REG_SZ, "Class", Class },
3077 { REG_SZ, "ClassGUID", ClassGUID },
3078 { REG_SZ, "Driver", Driver },
3079 { REG_DWORD, "ConfigFlags", ConfigFlags },
3080 { REG_SZ, "Mfg", Mfg },
3081 { REG_SZ, "FriendlyName", FriendlyName },
3082 { REG_SZ, "LocationInformation", LocationInformation },
3083 { 0, NULL, NULL }, /* SPDRP_PHYSICAL_DEVICE_OBJECT_NAME */
3084 { REG_DWORD, "Capabilities", Capabilities },
3085 { REG_DWORD, "UINumber", UINumber },
3086 { REG_MULTI_SZ, "UpperFilters", UpperFilters },
3087 { REG_MULTI_SZ, "LowerFilters", LowerFilters },
3090 /***********************************************************************
3091 * SetupDiGetDeviceRegistryPropertyA (SETUPAPI.@)
3093 BOOL WINAPI SetupDiGetDeviceRegistryPropertyA(
3094 HDEVINFO DeviceInfoSet,
3095 PSP_DEVINFO_DATA DeviceInfoData,
3097 PDWORD PropertyRegDataType,
3098 PBYTE PropertyBuffer,
3099 DWORD PropertyBufferSize,
3100 PDWORD RequiredSize)
3103 struct DeviceInfoSet *set = DeviceInfoSet;
3104 struct DeviceInfo *devInfo;
3106 TRACE("%04x %p %d %p %p %d %p\n", (DWORD)DeviceInfoSet, DeviceInfoData,
3107 Property, PropertyRegDataType, PropertyBuffer, PropertyBufferSize,
3110 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
3112 SetLastError(ERROR_INVALID_HANDLE);
3115 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
3117 SetLastError(ERROR_INVALID_HANDLE);
3120 if (!DeviceInfoData || DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA)
3121 || !DeviceInfoData->Reserved)
3123 SetLastError(ERROR_INVALID_PARAMETER);
3126 if (PropertyBufferSize && PropertyBuffer == NULL)
3128 SetLastError(ERROR_INVALID_DATA);
3131 devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
3132 if (Property < sizeof(PropertyMap) / sizeof(PropertyMap[0])
3133 && PropertyMap[Property].nameA)
3135 DWORD size = PropertyBufferSize;
3136 LONG l = RegQueryValueExA(devInfo->key, PropertyMap[Property].nameA,
3137 NULL, PropertyRegDataType, PropertyBuffer, &size);
3139 if (l == ERROR_MORE_DATA || !PropertyBufferSize)
3140 SetLastError(ERROR_INSUFFICIENT_BUFFER);
3146 *RequiredSize = size;
3151 /***********************************************************************
3152 * SetupDiGetDeviceRegistryPropertyW (SETUPAPI.@)
3154 BOOL WINAPI SetupDiGetDeviceRegistryPropertyW(
3155 HDEVINFO DeviceInfoSet,
3156 PSP_DEVINFO_DATA DeviceInfoData,
3158 PDWORD PropertyRegDataType,
3159 PBYTE PropertyBuffer,
3160 DWORD PropertyBufferSize,
3161 PDWORD RequiredSize)
3164 struct DeviceInfoSet *set = DeviceInfoSet;
3165 struct DeviceInfo *devInfo;
3167 TRACE("%04x %p %d %p %p %d %p\n", (DWORD)DeviceInfoSet, DeviceInfoData,
3168 Property, PropertyRegDataType, PropertyBuffer, PropertyBufferSize,
3171 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
3173 SetLastError(ERROR_INVALID_HANDLE);
3176 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
3178 SetLastError(ERROR_INVALID_HANDLE);
3181 if (!DeviceInfoData || DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA)
3182 || !DeviceInfoData->Reserved)
3184 SetLastError(ERROR_INVALID_PARAMETER);
3187 if (PropertyBufferSize && PropertyBuffer == NULL)
3189 SetLastError(ERROR_INVALID_DATA);
3192 devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
3193 if (Property < sizeof(PropertyMap) / sizeof(PropertyMap[0])
3194 && PropertyMap[Property].nameW)
3196 DWORD size = PropertyBufferSize;
3197 LONG l = RegQueryValueExW(devInfo->key, PropertyMap[Property].nameW,
3198 NULL, PropertyRegDataType, PropertyBuffer, &size);
3200 if (l == ERROR_MORE_DATA || !PropertyBufferSize)
3201 SetLastError(ERROR_INSUFFICIENT_BUFFER);
3207 *RequiredSize = size;
3212 /***********************************************************************
3213 * SetupDiSetDeviceRegistryPropertyA (SETUPAPI.@)
3215 BOOL WINAPI SetupDiSetDeviceRegistryPropertyA(
3216 HDEVINFO DeviceInfoSet,
3217 PSP_DEVINFO_DATA DeviceInfoData,
3219 const BYTE *PropertyBuffer,
3220 DWORD PropertyBufferSize)
3223 struct DeviceInfoSet *set = DeviceInfoSet;
3224 struct DeviceInfo *devInfo;
3226 TRACE("%p %p %d %p %d\n", DeviceInfoSet, DeviceInfoData, Property,
3227 PropertyBuffer, PropertyBufferSize);
3229 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
3231 SetLastError(ERROR_INVALID_HANDLE);
3234 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
3236 SetLastError(ERROR_INVALID_HANDLE);
3239 if (!DeviceInfoData || DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA)
3240 || !DeviceInfoData->Reserved)
3242 SetLastError(ERROR_INVALID_PARAMETER);
3245 devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
3246 if (Property < sizeof(PropertyMap) / sizeof(PropertyMap[0])
3247 && PropertyMap[Property].nameA)
3249 LONG l = RegSetValueExA(devInfo->key, PropertyMap[Property].nameA, 0,
3250 PropertyMap[Property].regType, PropertyBuffer,
3251 PropertyBufferSize);
3260 /***********************************************************************
3261 * SetupDiSetDeviceRegistryPropertyW (SETUPAPI.@)
3263 BOOL WINAPI SetupDiSetDeviceRegistryPropertyW(
3264 HDEVINFO DeviceInfoSet,
3265 PSP_DEVINFO_DATA DeviceInfoData,
3267 const BYTE *PropertyBuffer,
3268 DWORD PropertyBufferSize)
3271 struct DeviceInfoSet *set = DeviceInfoSet;
3272 struct DeviceInfo *devInfo;
3274 TRACE("%p %p %d %p %d\n", DeviceInfoSet, DeviceInfoData, Property,
3275 PropertyBuffer, PropertyBufferSize);
3277 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
3279 SetLastError(ERROR_INVALID_HANDLE);
3282 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
3284 SetLastError(ERROR_INVALID_HANDLE);
3287 if (!DeviceInfoData || DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA)
3288 || !DeviceInfoData->Reserved)
3290 SetLastError(ERROR_INVALID_PARAMETER);
3293 devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
3294 if (Property < sizeof(PropertyMap) / sizeof(PropertyMap[0])
3295 && PropertyMap[Property].nameW)
3297 LONG l = RegSetValueExW(devInfo->key, PropertyMap[Property].nameW, 0,
3298 PropertyMap[Property].regType, PropertyBuffer,
3299 PropertyBufferSize);
3308 /***********************************************************************
3309 * SetupDiInstallClassA (SETUPAPI.@)
3311 BOOL WINAPI SetupDiInstallClassA(
3317 UNICODE_STRING FileNameW;
3322 SetLastError(ERROR_INVALID_PARAMETER);
3325 if (!RtlCreateUnicodeStringFromAsciiz(&FileNameW, InfFileName))
3327 SetLastError(ERROR_NOT_ENOUGH_MEMORY);
3331 Result = SetupDiInstallClassW(hwndParent, FileNameW.Buffer, Flags, FileQueue);
3333 RtlFreeUnicodeString(&FileNameW);
3338 static HKEY CreateClassKey(HINF hInf)
3340 static const WCHAR slash[] = { '\\',0 };
3341 WCHAR FullBuffer[MAX_PATH];
3342 WCHAR Buffer[MAX_PATH];
3346 if (!SetupGetLineTextW(NULL,
3354 return INVALID_HANDLE_VALUE;
3357 lstrcpyW(FullBuffer, ControlClass);
3358 lstrcatW(FullBuffer, slash);
3359 lstrcatW(FullBuffer, Buffer);
3361 if (RegOpenKeyExW(HKEY_LOCAL_MACHINE,
3367 if (!SetupGetLineTextW(NULL,
3375 return INVALID_HANDLE_VALUE;
3378 if (RegCreateKeyExW(HKEY_LOCAL_MACHINE,
3382 REG_OPTION_NON_VOLATILE,
3388 return INVALID_HANDLE_VALUE;
3393 if (RegSetValueExW(hClassKey,
3398 RequiredSize * sizeof(WCHAR)))
3400 RegCloseKey(hClassKey);
3401 RegDeleteKeyW(HKEY_LOCAL_MACHINE,
3403 return INVALID_HANDLE_VALUE;
3409 /***********************************************************************
3410 * SetupDiInstallClassW (SETUPAPI.@)
3412 BOOL WINAPI SetupDiInstallClassW(
3418 WCHAR SectionName[MAX_PATH];
3419 DWORD SectionNameLength = 0;
3421 BOOL bFileQueueCreated = FALSE;
3429 SetLastError(ERROR_INVALID_PARAMETER);
3432 if ((Flags & DI_NOVCP) && (FileQueue == NULL || FileQueue == INVALID_HANDLE_VALUE))
3434 SetLastError(ERROR_INVALID_PARAMETER);
3438 /* Open the .inf file */
3439 hInf = SetupOpenInfFileW(InfFileName,
3443 if (hInf == INVALID_HANDLE_VALUE)
3449 /* Create or open the class registry key 'HKLM\\CurrentControlSet\\Class\\{GUID}' */
3450 hClassKey = CreateClassKey(hInf);
3451 if (hClassKey == INVALID_HANDLE_VALUE)
3453 SetupCloseInfFile(hInf);
3458 /* Try to append a layout file */
3459 SetupOpenAppendInfFileW(NULL, hInf, NULL);
3461 /* Retrieve the actual section name */
3462 SetupDiGetActualSectionToInstallW(hInf,
3470 if (!(Flags & DI_NOVCP))
3472 FileQueue = SetupOpenFileQueue();
3473 if (FileQueue == INVALID_HANDLE_VALUE)
3475 SetupCloseInfFile(hInf);
3479 bFileQueueCreated = TRUE;
3484 SetupInstallFromInfSectionW(NULL,
3487 SPINST_COPYINF | SPINST_FILES | SPINST_REGISTRY,
3493 INVALID_HANDLE_VALUE,
3496 /* FIXME: More code! */
3498 if (bFileQueueCreated)
3499 SetupCloseFileQueue(FileQueue);
3501 SetupCloseInfFile(hInf);
3507 /***********************************************************************
3508 * SetupDiOpenClassRegKey (SETUPAPI.@)
3510 HKEY WINAPI SetupDiOpenClassRegKey(
3511 const GUID* ClassGuid,
3514 return SetupDiOpenClassRegKeyExW(ClassGuid, samDesired,
3515 DIOCR_INSTALLER, NULL, NULL);
3519 /***********************************************************************
3520 * SetupDiOpenClassRegKeyExA (SETUPAPI.@)
3522 HKEY WINAPI SetupDiOpenClassRegKeyExA(
3523 const GUID* ClassGuid,
3529 PWSTR MachineNameW = NULL;
3536 MachineNameW = MultiByteToUnicode(MachineName, CP_ACP);
3537 if (MachineNameW == NULL)
3538 return INVALID_HANDLE_VALUE;
3541 hKey = SetupDiOpenClassRegKeyExW(ClassGuid, samDesired,
3542 Flags, MachineNameW, Reserved);
3544 MyFree(MachineNameW);
3550 /***********************************************************************
3551 * SetupDiOpenClassRegKeyExW (SETUPAPI.@)
3553 HKEY WINAPI SetupDiOpenClassRegKeyExW(
3554 const GUID* ClassGuid,
3565 if (MachineName && *MachineName)
3567 FIXME("Remote access not supported yet!\n");
3568 return INVALID_HANDLE_VALUE;
3571 if (Flags == DIOCR_INSTALLER)
3573 lpKeyName = ControlClass;
3575 else if (Flags == DIOCR_INTERFACE)
3577 lpKeyName = DeviceClasses;
3581 ERR("Invalid Flags parameter!\n");
3582 SetLastError(ERROR_INVALID_PARAMETER);
3583 return INVALID_HANDLE_VALUE;
3588 if ((l = RegOpenKeyExW(HKEY_LOCAL_MACHINE,
3595 hClassesKey = INVALID_HANDLE_VALUE;
3601 WCHAR bracedGuidString[39];
3603 SETUPDI_GuidToString(ClassGuid, bracedGuidString);
3605 if (!(l = RegOpenKeyExW(HKEY_LOCAL_MACHINE,
3611 if ((l = RegOpenKeyExW(hClassesKey,
3618 key = INVALID_HANDLE_VALUE;
3620 RegCloseKey(hClassesKey);
3625 key = INVALID_HANDLE_VALUE;
3631 /***********************************************************************
3632 * SetupDiOpenDeviceInterfaceW (SETUPAPI.@)
3634 BOOL WINAPI SetupDiOpenDeviceInterfaceW(
3635 HDEVINFO DeviceInfoSet,
3638 PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData)
3640 FIXME("%p %s %08x %p\n",
3641 DeviceInfoSet, debugstr_w(DevicePath), OpenFlags, DeviceInterfaceData);
3645 /***********************************************************************
3646 * SetupDiOpenDeviceInterfaceA (SETUPAPI.@)
3648 BOOL WINAPI SetupDiOpenDeviceInterfaceA(
3649 HDEVINFO DeviceInfoSet,
3652 PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData)
3654 FIXME("%p %s %08x %p\n", DeviceInfoSet,
3655 debugstr_a(DevicePath), OpenFlags, DeviceInterfaceData);
3659 /***********************************************************************
3660 * SetupDiSetClassInstallParamsA (SETUPAPI.@)
3662 BOOL WINAPI SetupDiSetClassInstallParamsA(
3663 HDEVINFO DeviceInfoSet,
3664 PSP_DEVINFO_DATA DeviceInfoData,
3665 PSP_CLASSINSTALL_HEADER ClassInstallParams,
3666 DWORD ClassInstallParamsSize)
3668 FIXME("%p %p %x %u\n",DeviceInfoSet, DeviceInfoData,
3669 ClassInstallParams->InstallFunction, ClassInstallParamsSize);
3673 /***********************************************************************
3674 * SetupDiCallClassInstaller (SETUPAPI.@)
3676 BOOL WINAPI SetupDiCallClassInstaller(
3677 DI_FUNCTION InstallFunction,
3678 HDEVINFO DeviceInfoSet,
3679 PSP_DEVINFO_DATA DeviceInfoData)
3681 FIXME("%d %p %p\n", InstallFunction, DeviceInfoSet, DeviceInfoData);
3685 /***********************************************************************
3686 * SetupDiGetDeviceInstallParamsW (SETUPAPI.@)
3688 BOOL WINAPI SetupDiGetDeviceInstallParamsW(
3689 HDEVINFO DeviceInfoSet,
3690 PSP_DEVINFO_DATA DeviceInfoData,
3691 PSP_DEVINSTALL_PARAMS_W DeviceInstallParams)
3693 FIXME("%p %p %p\n", DeviceInfoSet, DeviceInfoData, DeviceInstallParams);
3697 /***********************************************************************
3698 * SetupDiGetDeviceInstallParamsA (SETUPAPI.@)
3700 BOOL WINAPI SetupDiGetDeviceInstallParamsA(
3701 HDEVINFO DeviceInfoSet,
3702 PSP_DEVINFO_DATA DeviceInfoData,
3703 PSP_DEVINSTALL_PARAMS_A DeviceInstallParams)
3705 FIXME("%p %p %p\n", DeviceInfoSet, DeviceInfoData, DeviceInstallParams);
3709 static HKEY SETUPDI_OpenDevKey(struct DeviceInfo *devInfo, REGSAM samDesired)
3711 HKEY enumKey, key = INVALID_HANDLE_VALUE;
3714 l = RegCreateKeyExW(HKEY_LOCAL_MACHINE, Enum, 0, NULL, 0, KEY_ALL_ACCESS,
3715 NULL, &enumKey, NULL);
3718 RegOpenKeyExW(enumKey, devInfo->instanceId, 0, samDesired, &key);
3719 RegCloseKey(enumKey);
3724 static HKEY SETUPDI_OpenDrvKey(struct DeviceInfo *devInfo, REGSAM samDesired)
3726 static const WCHAR slash[] = { '\\',0 };
3727 WCHAR classKeyPath[MAX_PATH];
3728 HKEY classKey, key = INVALID_HANDLE_VALUE;
3731 lstrcpyW(classKeyPath, ControlClass);
3732 lstrcatW(classKeyPath, slash);
3733 SETUPDI_GuidToString(&devInfo->set->ClassGuid,
3734 classKeyPath + lstrlenW(classKeyPath));
3735 l = RegCreateKeyExW(HKEY_LOCAL_MACHINE, classKeyPath, 0, NULL, 0,
3736 KEY_ALL_ACCESS, NULL, &classKey, NULL);
3739 static const WCHAR fmt[] = { '%','0','4','u',0 };
3742 sprintfW(devId, fmt, devInfo->devId);
3743 l = RegOpenKeyExW(classKey, devId, 0, samDesired, &key);
3744 RegCloseKey(classKey);
3747 SetLastError(ERROR_KEY_DOES_NOT_EXIST);
3748 return INVALID_HANDLE_VALUE;
3754 /***********************************************************************
3755 * SetupDiOpenDevRegKey (SETUPAPI.@)
3757 HKEY WINAPI SetupDiOpenDevRegKey(
3758 HDEVINFO DeviceInfoSet,
3759 PSP_DEVINFO_DATA DeviceInfoData,
3765 struct DeviceInfoSet *set = DeviceInfoSet;
3766 struct DeviceInfo *devInfo;
3767 HKEY key = INVALID_HANDLE_VALUE;
3769 TRACE("%p %p %d %d %d %x\n", DeviceInfoSet, DeviceInfoData,
3770 Scope, HwProfile, KeyType, samDesired);
3772 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
3774 SetLastError(ERROR_INVALID_HANDLE);
3775 return INVALID_HANDLE_VALUE;
3777 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
3779 SetLastError(ERROR_INVALID_HANDLE);
3780 return INVALID_HANDLE_VALUE;
3782 if (!DeviceInfoData || DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA)
3783 || !DeviceInfoData->Reserved)
3785 SetLastError(ERROR_INVALID_PARAMETER);
3786 return INVALID_HANDLE_VALUE;
3788 if (Scope != DICS_FLAG_GLOBAL && Scope != DICS_FLAG_CONFIGSPECIFIC)
3790 SetLastError(ERROR_INVALID_FLAGS);
3791 return INVALID_HANDLE_VALUE;
3793 if (KeyType != DIREG_DEV && KeyType != DIREG_DRV)
3795 SetLastError(ERROR_INVALID_FLAGS);
3796 return INVALID_HANDLE_VALUE;
3798 devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
3799 if (devInfo->set != set)
3801 SetLastError(ERROR_INVALID_PARAMETER);
3802 return INVALID_HANDLE_VALUE;
3804 if (devInfo->phantom)
3806 SetLastError(ERROR_DEVINFO_NOT_REGISTERED);
3807 return INVALID_HANDLE_VALUE;
3809 if (Scope != DICS_FLAG_GLOBAL)
3810 FIXME("unimplemented for scope %d\n", Scope);
3814 key = SETUPDI_OpenDevKey(devInfo, samDesired);
3817 key = SETUPDI_OpenDrvKey(devInfo, samDesired);
3820 WARN("unknown KeyType %d\n", KeyType);
3825 static BOOL SETUPDI_DeleteDevKey(struct DeviceInfo *devInfo)
3831 l = RegCreateKeyExW(HKEY_LOCAL_MACHINE, Enum, 0, NULL, 0, KEY_ALL_ACCESS,
3832 NULL, &enumKey, NULL);
3835 ret = RegDeleteTreeW(enumKey, devInfo->instanceId);
3836 RegCloseKey(enumKey);
3843 static BOOL SETUPDI_DeleteDrvKey(struct DeviceInfo *devInfo)
3845 static const WCHAR slash[] = { '\\',0 };
3846 WCHAR classKeyPath[MAX_PATH];
3851 lstrcpyW(classKeyPath, ControlClass);
3852 lstrcatW(classKeyPath, slash);
3853 SETUPDI_GuidToString(&devInfo->set->ClassGuid,
3854 classKeyPath + lstrlenW(classKeyPath));
3855 l = RegCreateKeyExW(HKEY_LOCAL_MACHINE, classKeyPath, 0, NULL, 0,
3856 KEY_ALL_ACCESS, NULL, &classKey, NULL);
3859 static const WCHAR fmt[] = { '%','0','4','u',0 };
3862 sprintfW(devId, fmt, devInfo->devId);
3863 ret = RegDeleteTreeW(classKey, devId);
3864 RegCloseKey(classKey);
3871 /***********************************************************************
3872 * SetupDiDeleteDevRegKey (SETUPAPI.@)
3874 BOOL WINAPI SetupDiDeleteDevRegKey(
3875 HDEVINFO DeviceInfoSet,
3876 PSP_DEVINFO_DATA DeviceInfoData,
3881 struct DeviceInfoSet *set = DeviceInfoSet;
3882 struct DeviceInfo *devInfo;
3885 TRACE("%p %p %d %d %d\n", DeviceInfoSet, DeviceInfoData, Scope, HwProfile,
3888 if (!DeviceInfoSet || DeviceInfoSet == INVALID_HANDLE_VALUE)
3890 SetLastError(ERROR_INVALID_HANDLE);
3893 if (set->magic != SETUP_DEVICE_INFO_SET_MAGIC)
3895 SetLastError(ERROR_INVALID_HANDLE);
3898 if (!DeviceInfoData || DeviceInfoData->cbSize != sizeof(SP_DEVINFO_DATA)
3899 || !DeviceInfoData->Reserved)
3901 SetLastError(ERROR_INVALID_PARAMETER);
3904 if (Scope != DICS_FLAG_GLOBAL && Scope != DICS_FLAG_CONFIGSPECIFIC)
3906 SetLastError(ERROR_INVALID_FLAGS);
3909 if (KeyType != DIREG_DEV && KeyType != DIREG_DRV && KeyType != DIREG_BOTH)
3911 SetLastError(ERROR_INVALID_FLAGS);
3914 devInfo = (struct DeviceInfo *)DeviceInfoData->Reserved;
3915 if (devInfo->set != set)
3917 SetLastError(ERROR_INVALID_PARAMETER);
3920 if (devInfo->phantom)
3922 SetLastError(ERROR_DEVINFO_NOT_REGISTERED);
3925 if (Scope != DICS_FLAG_GLOBAL)
3926 FIXME("unimplemented for scope %d\n", Scope);
3930 ret = SETUPDI_DeleteDevKey(devInfo);
3933 ret = SETUPDI_DeleteDrvKey(devInfo);
3936 ret = SETUPDI_DeleteDevKey(devInfo);
3938 ret = SETUPDI_DeleteDrvKey(devInfo);
3941 WARN("unknown KeyType %d\n", KeyType);
3946 /***********************************************************************
3947 * CM_Get_Device_IDA (SETUPAPI.@)
3949 CONFIGRET WINAPI CM_Get_Device_IDA( DEVINST dnDevInst, PSTR Buffer,
3950 ULONG BufferLen, ULONG ulFlags)
3952 struct DeviceInfo *devInfo = GlobalLock((HANDLE)dnDevInst);
3954 TRACE("%x->%p, %p, %u %u\n", dnDevInst, devInfo, Buffer, BufferLen, ulFlags);
3957 return CR_NO_SUCH_DEVINST;
3959 WideCharToMultiByte(CP_ACP, 0, devInfo->instanceId, -1, Buffer, BufferLen, 0, 0);
3960 TRACE("Returning %s\n", debugstr_a(Buffer));
3964 /***********************************************************************
3965 * CM_Get_Device_IDW (SETUPAPI.@)
3967 CONFIGRET WINAPI CM_Get_Device_IDW( DEVINST dnDevInst, LPWSTR Buffer,
3968 ULONG BufferLen, ULONG ulFlags)
3970 struct DeviceInfo *devInfo = GlobalLock((HANDLE)dnDevInst);
3972 TRACE("%x->%p, %p, %u %u\n", dnDevInst, devInfo, Buffer, BufferLen, ulFlags);
3976 WARN("dev instance %d not found!\n", dnDevInst);
3977 return CR_NO_SUCH_DEVINST;
3980 lstrcpynW(Buffer, devInfo->instanceId, BufferLen);
3981 TRACE("Returning %s\n", debugstr_w(Buffer));
3982 GlobalUnlock((HANDLE)dnDevInst);
3988 /***********************************************************************
3989 * CM_Get_Device_ID_Size (SETUPAPI.@)
3991 CONFIGRET WINAPI CM_Get_Device_ID_Size( PULONG pulLen, DEVINST dnDevInst,
3994 struct DeviceInfo *ppdevInfo = GlobalLock((HANDLE)dnDevInst);
3996 TRACE("%x->%p, %p, %u\n", dnDevInst, ppdevInfo, pulLen, ulFlags);
4000 WARN("dev instance %d not found!\n", dnDevInst);
4001 return CR_NO_SUCH_DEVINST;
4004 *pulLen = lstrlenW(ppdevInfo->instanceId);
4005 GlobalUnlock((HANDLE)dnDevInst);
4009 /***********************************************************************
4010 * SetupDiGetINFClassA (SETUPAPI.@)
4012 BOOL WINAPI SetupDiGetINFClassA(PCSTR inf, LPGUID class_guid, PSTR class_name,
4013 DWORD size, PDWORD required_size)
4016 DWORD required_sizeA, required_sizeW;
4017 PWSTR class_nameW = NULL;
4018 UNICODE_STRING infW;
4022 if (!RtlCreateUnicodeStringFromAsciiz(&infW, inf))
4024 SetLastError(ERROR_NOT_ENOUGH_MEMORY);
4031 if (class_name && size)
4033 if (!(class_nameW = HeapAlloc(GetProcessHeap(), 0, size * sizeof(WCHAR))))
4035 RtlFreeUnicodeString(&infW);
4036 SetLastError(ERROR_NOT_ENOUGH_MEMORY);
4041 retval = SetupDiGetINFClassW(infW.Buffer, class_guid, class_nameW, size, &required_sizeW);
4045 required_sizeA = WideCharToMultiByte( CP_ACP, 0, class_nameW, required_sizeW,
4046 class_name, size, NULL, NULL);
4048 if(required_size) *required_size = required_sizeA;
4051 if(required_size) *required_size = required_sizeW;
4053 HeapFree(GetProcessHeap(), 0, class_nameW);
4054 RtlFreeUnicodeString(&infW);
4058 /***********************************************************************
4059 * SetupDiGetINFClassW (SETUPAPI.@)
4061 BOOL WINAPI SetupDiGetINFClassW(PCWSTR inf, LPGUID class_guid, PWSTR class_name,
4062 DWORD size, PDWORD required_size)
4064 BOOL have_guid, have_name;
4066 WCHAR buffer[MAX_PATH];
4070 SetLastError(ERROR_INVALID_PARAMETER);
4074 if (INVALID_FILE_ATTRIBUTES == GetFileAttributesW(inf))
4076 FIXME("%s not found. Searching via DevicePath not implemented\n", debugstr_w(inf));
4077 SetLastError(ERROR_FILE_NOT_FOUND);
4081 if (!class_guid || !class_name || !size)
4083 SetLastError(ERROR_INVALID_PARAMETER);
4087 if (!GetPrivateProfileStringW(Version, Signature, NULL, buffer, MAX_PATH, inf))
4090 if (lstrcmpiW(buffer, Chicago))
4094 have_guid = 0 < GetPrivateProfileStringW(Version, ClassGUID, NULL, buffer, MAX_PATH, inf);
4097 buffer[lstrlenW(buffer)-1] = 0;
4098 if (RPC_S_OK != UuidFromStringW(buffer + 1, class_guid))
4100 FIXME("failed to convert \"%s\" into a guid\n", debugstr_w(buffer));
4101 SetLastError(ERROR_INVALID_PARAMETER);
4107 dret = GetPrivateProfileStringW(Version, Class, NULL, buffer, MAX_PATH, inf);
4108 have_name = 0 < dret;
4110 if (dret >= MAX_PATH -1) FIXME("buffer might be too small\n");
4111 if (have_guid && !have_name) FIXME("class name lookup via guid not implemented\n");
4115 if (dret < size) lstrcpyW(class_name, buffer);
4118 SetLastError(ERROR_INSUFFICIENT_BUFFER);
4123 if (required_size) *required_size = dret + ((dret) ? 1 : 0);
4125 return (have_guid || have_name);