setupapi: Add helper functions to get the path of the device instance keys.
[wine.git] / include / cfgmgr32.h
blobb8def604aa7c3f316a21aaf1eee9f589b723e7af
1 /*
2 * Copyright (C) 2005 Mike McCormack
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2.1 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
19 #ifndef _CFGMGR32_H_
20 #define _CFGMGR32_H_
22 /* FIXME: #include <cfg.h> */
24 #ifndef GUID_DEFINED
25 # include <guiddef.h>
26 #endif
28 #include <winreg.h>
30 /* cfgmgr32 doesn't use the normal convention, it adds an underscore before A/W */
31 #ifdef WINE_NO_UNICODE_MACROS
32 # define DECL_WINELIB_CFGMGR32_TYPE_AW(type) /* nothing */
33 #else
34 # define DECL_WINELIB_CFGMGR32_TYPE_AW(type) typedef WINELIB_NAME_AW(type##_) type;
35 #endif
37 #define CMAPI
38 typedef DWORD CONFIGRET;
40 #define CR_SUCCESS 0x00
41 #define CR_DEFAULT 0x01
42 #define CR_OUT_OF_MEMORY 0x02
43 #define CR_INVALID_POINTER 0x03
44 #define CR_INVALID_FLAG 0x04
45 #define CR_INVALID_DEVNODE 0x05
46 #define CR_INVALID_DEVINST CR_INVALID_DEVNODE
47 #define CR_INVALID_RES_DES 0x06
48 #define CR_INVALID_LOG_CONF 0x07
49 #define CR_INVALID_ARBITRATOR 0x08
50 #define CR_INVALID_NODELIST 0x09
51 #define CR_DEVNODE_HAS_REQS 0x0a
52 #define CR_DEVINST_HAS_REQS CR_DEVNODE_HAS_REQS
53 #define CR_INVALID_RESOURCEID 0x0b
54 #define CR_DLVXD_NOT_FOUND 0x0c
55 #define CR_NO_SUCH_DEVNODE 0x0d
56 #define CR_NO_SUCH_DEVINST CR_NO_SUCH_DEVNODE
57 #define CR_NO_MORE_LOG_CONF 0x0e
58 #define CR_NO_MORE_RES_DES 0x0f
59 #define CR_ALREADY_SUCH_DEVNODE 0x10
60 #define CR_ALREADY_SUCH_DEVINST CR_ALREADY_SUCH_DEVNODE
61 #define CR_INVALID_RANGE_LIST 0x11
62 #define CR_INVALID_RANGE 0x12
63 #define CR_FAILURE 0x13
64 #define CR_NO_SUCH_LOGICAL_DEV 0x14
65 #define CR_CREATE_BLOCKED 0x15
66 #define CR_NOT_SYSTEM_VM 0x16
67 #define CR_REMOVE_VETOED 0x17
68 #define CR_APM_VETOED 0x18
69 #define CR_INVALID_LOAD_TYPE 0x19
70 #define CR_BUFFER_SMALL 0x1a
71 #define CR_NO_ARBITRATOR 0x1b
72 #define CR_NO_REGISTRY_HANDLE 0x1c
73 #define CR_REGISTRY_ERROR 0x1d
74 #define CR_INVALID_DEVICE_ID 0x1e
75 #define CR_INVALID_DATA 0x1f
76 #define CR_INVALID_API 0x20
77 #define CR_DEVLOADER_NOT_READY 0x21
78 #define CR_NEED_RESTART 0x22
79 #define CR_NO_MORE_HW_PROFILES 0x23
80 #define CR_DEVICE_NOT_THERE 0x24
81 #define CR_NO_SUCH_VALUE 0x25
82 #define CR_WRONG_TYPE 0x26
83 #define CR_INVALID_PRIORITY 0x27
84 #define CR_NOT_DISABLEABLE 0x28
85 #define CR_FREE_RESOURCES 0x29
86 #define CR_QUERY_VETOED 0x2a
87 #define CR_CANT_SHARE_IRQ 0x2b
88 #define CR_NO_DEPENDENT 0x2c
89 #define CR_SAME_RESOURCES 0x2d
90 #define CR_NO_SUCH_REGISTRY_KEY 0x2e
91 #define CR_INVALID_MACHINENAME 0x2f
92 #define CR_REMOTE_COMM_FAILURE 0x30
93 #define CR_MACHINE_UNAVAILABLE 0x31
94 #define CR_NO_CM_SERVICES 0x32
95 #define CR_ACCESS_DENIED 0x33
96 #define CR_CALL_NOT_IMPLEMENTED 0x34
97 #define CR_INVALID_PROPERTY 0x35
98 #define CR_DEVICE_INTERFACE_ACTIVE 0x36
99 #define CR_NO_SUCH_DEVICE_INTERFACE 0x37
100 #define CR_INVALID_REFERENCE_STRING 0x38
101 #define CR_INVALID_CONFLICT_LIST 0x39
102 #define CR_INVALID_INDEX 0x3a
103 #define CR_INVALID_STRUCTURE_SIZE 0x3b
104 #define NUM_CR_RESULTS 0x3c
106 #define MAX_DEVICE_ID_LEN 200
107 #define MAX_DEVNODE_ID_LEN MAX_DEVICE_ID_LEN
109 #define MAX_CLASS_NAME_LEN 32
110 #define MAX_GUID_STRING_LEN 39
111 #define MAX_PROFILE_LEN 80
113 #define CM_DRP_DEVICEDESC 0x01
114 #define CM_DRP_HARDWAREID 0x02
115 #define CM_DRP_COMPATIBLEIDS 0x03
116 #define CM_DRP_UNUSED0 0x04
117 #define CM_DRP_SERVICE 0x05
118 #define CM_DRP_UNUSED1 0x06
119 #define CM_DRP_UNUSED2 0x07
120 #define CM_DRP_CLASS 0x08
121 #define CM_DRP_CLASSGUID 0x09
122 #define CM_DRP_DRIVER 0x0A
123 #define CM_DRP_CONFIGFLAGS 0x0B
124 #define CM_DRP_MFG 0x0C
125 #define CM_DRP_FRIENDLYNAME 0x0D
126 #define CM_DRP_LOCATION_INFORMATION 0x0E
127 #define CM_DRP_PHYSICAL_DEVICE_OBJECT_NAME 0x0F
128 #define CM_DRP_CAPABILITIES 0x10
129 #define CM_DRP_UI_NUMBER 0x11
130 #define CM_DRP_UPPERFILTERS 0x12
131 #define CM_DRP_LOWERFILTERS 0x13
132 #define CM_DRP_BUSTYPEGUID 0x14
133 #define CM_DRP_LEGACYBUSTYPE 0x15
134 #define CM_DRP_BUSNUMBER 0x16
135 #define CM_DRP_ENUMERATOR_NAME 0x17
136 #define CM_DRP_SECURITY 0x18
137 #define CM_DRP_SECURITY_SDS 0x19
138 #define CM_DRP_DEVTYPE 0x1A
139 #define CM_DRP_EXCLUSIVE 0x1B
140 #define CM_DRP_CHARACTERISTICS 0x1C
141 #define CM_DRP_ADDRESS 0x1D
142 #define CM_DRP_UI_NUMBER_DESC_FORMAT 0x1E
143 #define CM_DRP_DEVICE_POWER_DATA 0x1F
144 #define CM_DRP_REMOVAL_POLICY 0x20
145 #define CM_DRP_REMOVAL_POLICY_HW_DEFAULT 0x21
146 #define CM_DRP_REMOVAL_POLICY_OVERRIDE 0x22
147 #define CM_DRP_INSTALL_STATE 0x23
148 #define CM_DRP_LOCATION_PATHS 0x24
149 #define CM_DRP_BASE_CONTAINERID 0x25
150 #define CM_DRP_MIN 0x01
151 #define CM_DRP_MAX 0x25
153 #define CM_CRP_UPPERFILTERS CM_DRP_UPPERFILTERS
154 #define CM_CRP_LOWERFILTERS CM_DRP_LOWERFILTERS
155 #define CM_CRP_SECURITY CM_DRP_SECURITY
156 #define CM_CRP_SECURITY_SDS CM_DRP_SECURITY_SDS
157 #define CM_CRP_DEVTYPE CM_DRP_DEVTYPE
158 #define CM_CRP_EXCLUSIVE CM_DRP_EXCLUSIVE
159 #define CM_CRP_CHARACTERISTICS CM_DRP_CHARACTERISTICS
160 #define CM_CRP_MIN CM_DRP_MIN
161 #define CM_CRP_MAX CM_DRP_MAX
163 #define RegDisposition_OpenAlways 0x00
164 #define RegDisposition_OpenExisting 0x01
166 #define CM_REGISTRY_HARDWARE 0x0000
167 #define CM_REGISTRY_SOFTWARE 0x0001
168 #define CM_REGISTRY_USER 0x0100
169 #define CM_REGISTRY_CONFIG 0x0200
171 typedef DWORD DEVINST, *PDEVINST;
172 typedef DWORD DEVNODE, *PDEVNODE;
173 typedef HANDLE HMACHINE, *PHMACHINE;
174 typedef CHAR *DEVNODEID_A, *DEVINSTID_A;
175 typedef WCHAR *DEVNODEID_W, *DEVINSTID_W;
176 typedef ULONG REGDISPOSITION;
178 DECL_WINELIB_CFGMGR32_TYPE_AW(DEVNODEID)
179 DECL_WINELIB_CFGMGR32_TYPE_AW(DEVINSTID)
181 #ifdef __cplusplus
182 extern "C" {
183 #endif
185 CMAPI CONFIGRET WINAPI CM_Connect_MachineA(PCSTR,PHMACHINE);
186 CMAPI CONFIGRET WINAPI CM_Connect_MachineW(PCWSTR,PHMACHINE);
187 #define CM_Connect_Machine WINELIB_NAME_AW(CM_Connect_Machine)
188 CMAPI CONFIGRET WINAPI CM_Create_DevNodeA(PDEVINST,DEVINSTID_A,DEVINST,ULONG);
189 CMAPI CONFIGRET WINAPI CM_Create_DevNodeW(PDEVINST,DEVINSTID_W,DEVINST,ULONG);
190 #define CM_Create_DevNode WINELIB_NAME_AW(CM_Create_DevNode)
191 CMAPI CONFIGRET WINAPI CM_Disconnect_Machine(HMACHINE);
192 CMAPI CONFIGRET WINAPI CM_Get_Child(PDEVINST pdnDevInst, DEVINST dnDevInst, ULONG ulFlags);
193 CMAPI CONFIGRET WINAPI CM_Get_Child_Ex(PDEVINST pdnDevInst, DEVINST dnDevInst, ULONG ulFlags, HMACHINE hMachine);
194 CMAPI CONFIGRET WINAPI CM_Get_Device_IDA(DEVINST,PSTR,ULONG,ULONG);
195 CMAPI CONFIGRET WINAPI CM_Get_Device_IDW(DEVINST,PWSTR,ULONG,ULONG);
196 #define CM_Get_Device_ID WINELIB_NAME_AW(CM_Get_Device_ID)
197 CMAPI CONFIGRET WINAPI CM_Get_Device_ID_ExA(DEVINST,PSTR,ULONG,ULONG,HMACHINE);
198 CMAPI CONFIGRET WINAPI CM_Get_Device_ID_ExW(DEVINST,PWSTR,ULONG,ULONG,HMACHINE);
199 #define CM_Get_Device_ID_Ex WINELIB_NAME_AW(CM_Get_Device_ID_Ex)
200 CMAPI CONFIGRET WINAPI CM_Get_Device_ID_ListA(PCSTR,PCHAR,ULONG,ULONG);
201 CMAPI CONFIGRET WINAPI CM_Get_Device_ID_ListW(PCWSTR,PWCHAR,ULONG,ULONG);
202 #define CM_Get_Device_ID_List WINELIB_NAME_AW(CM_Get_Device_ID_List)
203 CMAPI CONFIGRET WINAPI CM_Get_Device_ID_List_ExA(PCSTR,PCHAR,ULONG,ULONG,HMACHINE);
204 CMAPI CONFIGRET WINAPI CM_Get_Device_ID_List_ExW(PCWSTR,PWCHAR,ULONG,ULONG,HMACHINE);
205 #define CM_Get_Device_ID_List_Ex WINELIB_NAME_AW(CM_Get_Device_ID_List_Ex)
206 CMAPI CONFIGRET WINAPI CM_Get_Device_ID_Size(PULONG,DEVINST,ULONG);
207 CMAPI CONFIGRET WINAPI CM_Get_Device_ID_Size_Ex(PULONG,DEVINST,ULONG,HMACHINE);
208 CMAPI CONFIGRET WINAPI CM_Get_Sibling_Ex(PDEVINST pdnDevInst, DEVINST DevInst, ULONG ulFlags, HMACHINE hMachine);
209 CMAPI WORD WINAPI CM_Get_Version(void);
210 CMAPI CONFIGRET WINAPI CM_Locate_DevNodeA(PDEVINST,DEVINSTID_A,ULONG);
211 CMAPI CONFIGRET WINAPI CM_Locate_DevNodeW(PDEVINST,DEVINSTID_W,ULONG);
212 #define CM_Locate_DevNode WINELIB_NAME_AW(CM_Locate_DevNode)
213 CMAPI CONFIGRET WINAPI CM_Open_DevNode_Key(DEVINST dnDevInst, REGSAM access, ULONG ulHardwareProfile,
214 REGDISPOSITION disposition, PHKEY phkDevice, ULONG ulFlags);
216 #ifdef __cplusplus
218 #endif
220 #undef DECL_WINELIB_CFGMGR32_TYPE_AW
222 #endif /* _CFGMGR32_H_ */