reactos/lib/setupapi/setupapi_private.h

   1 /*
   2  * Copyright 2001 Andreas Mohr
   3  * Copyright 2005 Hervé Poussineau
   4  *
   5  * This library is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU Lesser General Public
   7  * License as published by the Free Software Foundation; either
   8  * version 2.1 of the License, or (at your option) any later version.
   9  *
  10  * This library is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13  * Lesser General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU Lesser General Public
  16  * License along with this library; if not, write to the Free Software
  17  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  18  */
  19
  20 #ifndef __SETUPAPI_PRIVATE_H
  21 #define __SETUPAPI_PRIVATE_H
  22
  23 #include <assert.h>
  24 #include <fcntl.h>
  25 #include <share.h>
  26 #include <wchar.h>
  27
  28 #define WIN32_NO_STATUS
  29 #include <windows.h>
  30 #include <cfgmgr32.h>
  31 #include <fdi.h>
  32 #include <setupapi.h>
  33 #include <shlobj.h>
  34 #include <wine/debug.h>
  35 #include <wine/unicode.h>
  36 #define NTOS_MODE_USER
  37 #include <ndk/ntndk.h>
  38
  39 #include <pnp_c.h>
  40 #include "rpc_private.h"
  41 #include "resource.h"
  42
  43 #define SETUP_DEV_INFO_SET_MAGIC 0xd00ff057
  44 #define SETUP_CLASS_IMAGE_LIST_MAGIC 0xd00ff058
  45
  46 struct DeviceInterface /* Element of DeviceInfoElement.InterfaceListHead */
  47 {
  48     LIST_ENTRY ListEntry;
  49
  50     struct DeviceInfoElement* DeviceInfo;
  51     GUID InterfaceClassGuid;
  52
  53
  54     /* SPINT_ACTIVE : the interface is active/enabled
  55      * SPINT_DEFAULT: the interface is the default interface for the device class FIXME???
  56      * SPINT_REMOVED: the interface is removed
  57      */
  58     DWORD Flags;
  59
  60     WCHAR SymbolicLink[ANYSIZE_ARRAY]; /* \\?\ACPI#PNP0501#4&2658d0a0&0#{GUID} */
  61 };
  62
  63 /* We don't want to open the .inf file to read only one information in it, so keep a handle to it once it
  64  * has been already loaded once. Keep also a reference counter */
  65 struct InfFileDetails
  66 {
  67     HINF hInf;
  68     LONG References;
  69
  70     /* May contain no directory if the file is already in %SYSTEMROOT%\Inf */
  71     WCHAR FullInfFileName[ANYSIZE_ARRAY];
  72 };
  73
  74 struct DriverInfoElement /* Element of DeviceInfoSet.DriverListHead and DeviceInfoElement.DriverListHead */
  75 {
  76     LIST_ENTRY ListEntry;
  77
  78     DWORD DriverRank;
  79     ULARGE_INTEGER DriverDate;
  80     SP_DRVINFO_DATA_V2_W Info;
  81     SP_DRVINFO_DETAIL_DATA_W Details;
  82     GUID ClassGuid;
  83     LPWSTR MatchingId;
  84     struct InfFileDetails *InfFileDetails;
  85 };
  86
  87 struct ClassInstallParams
  88 {
  89     PSP_PROPCHANGE_PARAMS PropChange;
  90 };
  91
  92 struct DeviceInfoElement /* Element of DeviceInfoSet.ListHead */
  93 {
  94     LIST_ENTRY ListEntry;
  95     DEVINST dnDevInst; /* Used in CM_* functions */
  96
  97     /* Reserved Field points to a struct DriverInfoElement */
  98     SP_DEVINSTALL_PARAMS_W InstallParams;
  99
 100     /* Information about devnode:
 101      * - DeviceName:
 102      *       "Root\*PNP0501" for example.
 103      *       It doesn't contain the unique ID for the device
 104      *       (points into the Data field at the end of the structure)
 105      *       WARNING: no NULL char exist between DeviceName and UniqueId
 106      *       in Data field!
 107      * - UniqueId
 108      *       "5&1be2108e&0" or "0000"
 109      *       If DICD_GENERATE_ID is specified in creation flags,
 110      *       this unique ID is autogenerated using 4 digits, base 10
 111      *       (points into the Data field at the end of the structure)
 112      * - DeviceDescription
 113      *       String which identifies the device. Can be NULL. If not NULL,
 114      *       points into the Data field at the end of the structure
 115      * - ClassGuid
 116      *       Identifies the class of this device. It is GUID_NULL if the
 117      *       device has not been installed
 118      * - CreationFlags
 119      *       Is a combination of:
 120      *       - DICD_GENERATE_ID
 121      *              the unique ID needs to be generated
 122      *       - DICD_INHERIT_CLASSDRVS
 123      *              inherit driver of the device info set (== same pointer)
 124      */
 125     PCWSTR DeviceName;
 126     PCWSTR UniqueId;
 127     PCWSTR DeviceDescription;
 128     GUID ClassGuid;
 129     DWORD CreationFlags;
 130
 131     /* If CreationFlags contains DICD_INHERIT_CLASSDRVS, this list is invalid */
 132     /* If the driver is not searched/detected, this list is empty */
 133     LIST_ENTRY DriverListHead; /* List of struct DriverInfoElement */
 134
 135     /* List of interfaces implemented by this device */
 136     LIST_ENTRY InterfaceListHead; /* List of struct DeviceInterface */
 137
 138     /* Used by SetupDiGetClassInstallParamsW/SetupDiSetClassInstallParamsW */
 139     struct ClassInstallParams ClassInstallParams;
 140
 141     WCHAR Data[ANYSIZE_ARRAY];
 142 };
 143
 144 struct DeviceInfoSet /* HDEVINFO */
 145 {
 146     DWORD magic; /* SETUP_DEV_INFO_SET_MAGIC */
 147     GUID ClassGuid; /* If != GUID_NULL, only devices of this class can be in the device info set */
 148     HKEY HKLM; /* Local or distant HKEY_LOCAL_MACHINE registry key */
 149     HMACHINE hMachine; /* Used in CM_* functions */
 150
 151     /* Reserved Field points to a struct DriverInfoElement */
 152     SP_DEVINSTALL_PARAMS_W InstallParams;
 153
 154     /* If the driver is not searched/detected, this list is empty */
 155     LIST_ENTRY DriverListHead; /* List of struct DriverInfoElement */
 156
 157     LIST_ENTRY ListHead; /* List of struct DeviceInfoElement */
 158
 159     /* Used by SetupDiGetClassInstallParamsW/SetupDiSetClassInstallParamsW */
 160     struct ClassInstallParams ClassInstallParams;
 161
 162     /* Contains the name of the remote computer ('\\COMPUTERNAME' for example),
 163      * or NULL if related to local machine. Points into szData field at the
 164      * end of the structure */
 165     PCWSTR MachineName;
 166     WCHAR szData[ANYSIZE_ARRAY];
 167 };
 168
 169 struct ClassImageList
 170 {
 171     DWORD magic; /* SETUP_CLASS_IMAGE_LIST_MAGIC */
 172
 173     /* Contains the name of the remote computer ('\\COMPUTERNAME' for example),
 174      * or NULL if related to local machine. Points into szData field at the
 175      * end of the structure */
 176     PCWSTR MachineName;
 177     WCHAR szData[ANYSIZE_ARRAY];
 178 };
 179
 180 extern HINSTANCE hInstance;
 181 #define RC_STRING_MAX_SIZE 256
 182
 183 #define REG_INSTALLEDFILES "System\\CurrentControlSet\\Control\\InstalledFiles"
 184 #define REGPART_RENAME "\\Rename"
 185 #define REG_VERSIONCONFLICT "Software\\Microsoft\\VersionConflictManager"
 186
 187 /* string substitutions */
 188
 189 struct inf_file;
 190 extern const WCHAR *DIRID_get_string( HINF hinf, int dirid );
 191 extern unsigned int PARSER_string_substA( struct inf_file *file, const WCHAR *text,
 192                                           char *buffer, unsigned int size );
 193 extern unsigned int PARSER_string_substW( struct inf_file *file, const WCHAR *text,
 194                                           WCHAR *buffer, unsigned int size );
 195 extern const WCHAR *PARSER_get_src_root( HINF hinf );
 196 extern WCHAR *PARSER_get_dest_dir( INFCONTEXT *context );
 197
 198 /* support for Ascii queue callback functions */
 199
 200 struct callback_WtoA_context
 201 {
 202     void               *orig_context;
 203     PSP_FILE_CALLBACK_A orig_handler;
 204 };
 205
 206 UINT CALLBACK QUEUE_callback_WtoA( void *context, UINT notification, UINT_PTR, UINT_PTR );
 207
 208 /* from msvcrt/sys/stat.h */
 209 #define _S_IWRITE 0x0080
 210 #define _S_IREAD  0x0100
 211
 212 extern HINSTANCE hInstance;
 213 extern OSVERSIONINFOW OsVersionInfo;
 214
 215 DWORD WINAPI CaptureAndConvertAnsiArg(LPCSTR pSrc, LPWSTR *pDst);
 216
 217 #endif /* __SETUPAPI_PRIVATE_H */