📄 cfgmgr32.h
字号:
typedef struct DevPrivate_Range_s {
DWORD PR_Data1; // mask for base alignment
DWORD PR_Data2; // number of bytes
DWORD PR_Data3; // minimum address
} DEVPRIVATE_RANGE, *PDEVPRIVATE_RANGE;
//
// DEVPRIVATE_DES structure
//
typedef struct DevPrivate_Des_s {
DWORD PD_Count;
DWORD PD_Type;
DWORD PD_Data1;
DWORD PD_Data2;
DWORD PD_Data3;
DWORD PD_Flags;
} DEVPRIVATE_DES, *PDEVPRIVATE_DES;
//
// DEVPRIVATE_RESOURCE
//
typedef struct DevPrivate_Resource_s {
DEVPRIVATE_DES PRV_Header;
DEVPRIVATE_RANGE PRV_Data[ANYSIZE_ARRAY];
} DEVPRIVATE_RESOURCE, *PDEVPRIVATE_RESOURCE;
//
// Define the size of each range structure
//
#define PType_Range sizeof(struct DevPrivate_Range_s)
//--------------------------------------------------------------
// Class-Specific Resource
//--------------------------------------------------------------
typedef struct CS_Des_s {
DWORD CSD_SignatureLength;
DWORD CSD_LegacyDataOffset;
DWORD CSD_LegacyDataSize;
DWORD CSD_Flags;
GUID CSD_ClassGuid;
BYTE CSD_Signature[ANYSIZE_ARRAY];
} CS_DES, *PCS_DES;
typedef struct CS_Resource_s {
CS_DES CS_Header;
} CS_RESOURCE, *PCS_RESOURCE;
//--------------------------------------------------------------
// PC Card Configuration Resource
//--------------------------------------------------------------
//
// Define the attribute flags for a PC Card configuration resource descriptor.
// Each bit flag is identified with a constant bitmask. Following the bitmask
// definition are the possible values.
//
#define mPCD_8_16 (0x1) // Bitmask, whether I/O is 8 or 16 bits
#define fPCD_8 (0x0) // I/O is 8-bit
#define fPCD_16 (0x1) // I/O is 16-bit
typedef struct PcCard_Des_s {
DWORD PCD_Flags;
BYTE PCD_ConfigIndex;
BYTE PCD_Reserved[3];
DWORD PCD_MemoryCardBase1;
DWORD PCD_MemoryCardBase2;
} PCCARD_DES, *PPCCARD_DES;
typedef struct PcCard_Resource_s {
PCCARD_DES PcCard_Header;
} PCCARD_RESOURCE, *PPCCARD_RESOURCE;
//--------------------------------------------------------------
// Bus Number Resource
//--------------------------------------------------------------
//
// Define the attribute flags for a Bus Number resource descriptor.
// Each bit flag is identified with a constant bitmask. Following the bitmask
// definition are the possible values.
//
// Currently unused.
//
//
// BUSNUMBER_RANGE
//
typedef struct BusNumber_Range_s {
ULONG BUSR_Min; // minimum Bus Number in the range
ULONG BUSR_Max; // maximum Bus Number in the range
ULONG BUSR_nBusNumbers; // specifies number of buses required
ULONG BUSR_Flags; // flags describing the range (currently unused)
} BUSNUMBER_RANGE, *PBUSNUMBER_RANGE;
//
// BUSNUMBER_DES structure
//
typedef struct BusNumber_Des_s {
DWORD BUSD_Count; // number of BUSNUMBER_RANGE structs in BUSNUMBER_RESOURCE
DWORD BUSD_Type; // size (in bytes) of BUSNUMBER_RANGE (BusNumberType_Range)
DWORD BUSD_Flags; // flags describing the range (currently unused)
ULONG BUSD_Alloc_Base; // specifies the first Bus that was allocated
ULONG BUSD_Alloc_End; // specifies the last Bus number that was allocated
} BUSNUMBER_DES, *PBUSNUMBER_DES;
//
// BUSNUMBER_RESOURCE structure
//
typedef struct BusNumber_Resource_s {
BUSNUMBER_DES BusNumber_Header; // info about Bus Number range list
BUSNUMBER_RANGE BusNumber_Data[ANYSIZE_ARRAY]; // list of Bus Number ranges
} BUSNUMBER_RESOURCE, *PBUSNUMBER_RESOURCE;
//
// Define the size of each range structure
//
#define BusNumberType_Range sizeof(struct BusNumber_Range_s)
//--------------------------------------------------------------
// Hardware Profile Information
//--------------------------------------------------------------
//
// Define flags relating to hardware profiles
//
#define CM_HWPI_NOT_DOCKABLE (0x00000000) // machine is not dockable
#define CM_HWPI_UNDOCKED (0x00000001) // hw profile for docked config
#define CM_HWPI_DOCKED (0x00000002) // hw profile for undocked config
//
// HWPROFILEINFO structure
//
typedef struct HWProfileInfo_sA {
ULONG HWPI_ulHWProfile; // handle of hw profile
CHAR HWPI_szFriendlyName[MAX_PROFILE_LEN]; // friendly name of hw profile
DWORD HWPI_dwFlags; // profile flags (CM_HWPI_*)
} HWPROFILEINFO_A, *PHWPROFILEINFO_A;
typedef struct HWProfileInfo_sW {
ULONG HWPI_ulHWProfile; // handle of hw profile
WCHAR HWPI_szFriendlyName[MAX_PROFILE_LEN]; // friendly name of hw profile
DWORD HWPI_dwFlags; // profile flags (CM_HWPI_*)
} HWPROFILEINFO_W, *PHWPROFILEINFO_W;
#ifdef UNICODE
typedef HWPROFILEINFO_W HWPROFILEINFO;
typedef PHWPROFILEINFO_W PHWPROFILEINFO;
#else
typedef HWPROFILEINFO_A HWPROFILEINFO;
typedef PHWPROFILEINFO_A PHWPROFILEINFO;
#endif
//
// revert back to normal default packing
//
#include "poppack.h"
//--------------------------------------------------------------
// Miscellaneous
//--------------------------------------------------------------
//
// Resource types
//
#define ResType_All (0x00000000) // Return all resource types
#define ResType_None (0x00000000) // Arbitration always succeeded
#define ResType_Mem (0x00000001) // Physical address resource
#define ResType_IO (0x00000002) // Physical I/O address resource
#define ResType_DMA (0x00000003) // DMA channels resource
#define ResType_IRQ (0x00000004) // IRQ resource
#define ResType_DoNotUse (0x00000005) // Used as spacer to sync subsequent ResTypes w/NT
#define ResType_BusNumber (0x00000006) // bus number resource
#define ResType_MAX (0x00000006) // Maximum known (arbitrated) ResType
#define ResType_Ignored_Bit (0x00008000) // Ignore this resource
#define ResType_ClassSpecific (0x0000FFFF) // class-specific resource
#define ResType_Reserved (0x00008000) // reserved for internal use
#define ResType_DevicePrivate (0x00008001) // device private data
#define ResType_PcCardConfig (0x00008002) // PC Card configuration data
//
// Flags specifying options for ranges that conflict with ranges already in
// the range list (CM_Add_Range)
//
#define CM_ADD_RANGE_ADDIFCONFLICT (0x00000000) // merg with conflicting range
#define CM_ADD_RANGE_DONOTADDIFCONFLICT (0x00000001) // error if range conflicts
#define CM_ADD_RANGE_BITS (0x00000001)
//
// Logical Config Flags (specified in call to CM_Get_First_Log_Conf
//
#define BASIC_LOG_CONF 0x00000000 // Specifies the req list.
#define FILTERED_LOG_CONF 0x00000001 // Specifies the filtered req list.
#define ALLOC_LOG_CONF 0x00000002 // Specifies the Alloc Element.
#define BOOT_LOG_CONF 0x00000003 // Specifies the RM Alloc Element.
#define FORCED_LOG_CONF 0x00000004 // Specifies the Forced Log Conf
#define OVERRIDE_LOG_CONF 0x00000005 // Specifies the Override req list.
#define NUM_LOG_CONF 0x00000006 // Number of Log Conf type
#define LOG_CONF_BITS 0x00000007 // The bits of the log conf type.
#define PRIORITY_EQUAL_FIRST (0x00000008) // Same priority, new one first
#define PRIORITY_EQUAL_LAST (0x00000000) // Same priority, new one last
#define PRIORITY_BIT (0x00000008)
//
// Registry disposition values
// (specified in call to CM_Open_DevNode_Key and CM_Open_Class_Key)
//
#define RegDisposition_OpenAlways (0x00000000) // open if exists else create
#define RegDisposition_OpenExisting (0x00000001) // open key only if exists
#define RegDisposition_Bits (0x00000001)
//
// ulFlags values for CM API routines
//
//
// Flags for CM_Add_ID
//
#define CM_ADD_ID_HARDWARE (0x00000000)
#define CM_ADD_ID_COMPATIBLE (0x00000001)
#define CM_ADD_ID_BITS (0x00000001)
//
// Device Node creation flags
//
#define CM_CREATE_DEVNODE_NORMAL (0x00000000) // install later
#define CM_CREATE_DEVNODE_NO_WAIT_INSTALL (0x00000001) // NOT SUPPORTED ON NT
#define CM_CREATE_DEVNODE_PHANTOM (0x00000002)
#define CM_CREATE_DEVNODE_GENERATE_ID (0x00000004)
#define CM_CREATE_DEVNODE_DO_NOT_INSTALL (0x00000008)
#define CM_CREATE_DEVNODE_BITS (0x0000000F)
#define CM_CREATE_DEVINST_NORMAL CM_CREATE_DEVNODE_NORMAL
#define CM_CREATE_DEVINST_NO_WAIT_INSTALL CM_CREATE_DEVNODE_NO_WAIT_INSTALL
#define CM_CREATE_DEVINST_PHANTOM CM_CREATE_DEVNODE_PHANTOM
#define CM_CREATE_DEVINST_GENERATE_ID CM_CREATE_DEVNODE_GENERATE_ID
#define CM_CREATE_DEVINST_DO_NOT_INSTALL CM_CREATE_DEVNODE_DO_NOT_INSTALL
#define CM_CREATE_DEVINST_BITS CM_CREATE_DEVNODE_BITS
//
// Flags for CM_Delete_Class_Key
//
#define CM_DELETE_CLASS_ONLY (0x00000000)
#define CM_DELETE_CLASS_SUBKEYS (0x00000001)
#define CM_DELETE_CLASS_BITS (0x00000001)
//
// Detection reason flags (specified in call to CM_Run_Detection)
//
#define CM_DETECT_NEW_PROFILE (0x00000001) // detection for new hw profile
#define CM_DETECT_CRASHED (0x00000002) // Previous detection crashed
#define CM_DETECT_HWPROF_FIRST_BOOT (0x00000004)
#define CM_DETECT_RUN (0x80000000)
#define CM_DETECT_BITS (0x80000007)
#define CM_DISABLE_POLITE (0x00000000) // Ask the driver
#define CM_DISABLE_ABSOLUTE (0x00000001) // Don't ask the driver
#define CM_DISABLE_HARDWARE (0x00000002) // Don't ask the driver, and won't be restarteable
#define CM_DISABLE_BITS (0x00000003) // The bits for the disable function
//
// Flags for CM_Get_Device_ID_List, CM_Get_Device_ID_List_Size
//
#define CM_GETIDLIST_FILTER_NONE (0x00000000)
#define CM_GETIDLIST_FILTER_ENUMERATOR (0x00000001)
#define CM_GETIDLIST_FILTER_SERVICE (0x00000002)
#define CM_GETIDLIST_FILTER_EJECTRELATIONS (0x00000004)
#define CM_GETIDLIST_FILTER_REMOVALRELATIONS (0x00000008)
#define CM_GETIDLIST_FILTER_POWERRELATIONS (0x00000010)
#define CM_GETIDLIST_FILTER_BUSRELATIONS (0x00000020)
#define CM_GETIDLIST_DONOTGENERATE (0x10000040)
#define CM_GETIDLIST_FILTER_BITS (0x1000007F)
//
// Flags for CM_Get_Device_Interface_List, CM_Get_Device_Interface_List_Size
//
#define CM_GET_DEVICE_INTERFACE_LIST_PRESENT (0x00000000) // only currently 'live' device interfaces
#define CM_GET_DEVICE_INTERFACE_LIST_ALL_DEVICES (0x00000001) // all registered device interfaces, live or not
#define CM_GET_DEVICE_INTERFACE_LIST_BITS (0x00000001)
//
// Registry properties (specified in call to CM_Get_DevInst_Registry_Property,
// some are allowed in calls to CM_Set_DevInst_Registry_Property)
//
#define CM_DRP_DEVICEDESC (0x00000001) // DeviceDesc REG_SZ property (RW)
#define CM_DRP_HARDWAREID (0x00000002) // HardwareID REG_MULTI_SZ property (RW)
#define CM_DRP_COMPATIBLEIDS (0x00000003) // CompatibleIDs REG_MULTI_SZ property (RW)
#define CM_DRP_NTDEVICEPATHS (0x00000004) // Unsupported, DO NOT USE
#define CM_DRP_SERVICE (0x00000005) // Service REG_SZ property (RW)
#define CM_DRP_CONFIGURATION (0x00000006) // Configuration REG_RESOURCE_LIST property (R)
#define CM_DRP_CONFIGURATIONVECTOR (0x00000007) // ConfigurationVector REG_RESOURCE_REQUIREMENTS_LIST property (R)
#define CM_DRP_CLASS (0x00000008) // Class REG_SZ property (RW)
#define CM_DRP_CLASSGUID (0x00000009) // ClassGUID REG_SZ property (RW)
#define CM_DRP_DRIVER (0x0000000A) // Driver REG_SZ property (RW)
#define CM_DRP_CONFIGFLAGS (0x0000000B) // ConfigFlags REG_DWORD property (RW)
#define CM_DRP_MFG (0x0000000C) // Mfg REG_SZ property (RW)
#define CM_DRP_FRIENDLYNAME (0x0000000D) // FriendlyName REG_SZ property (RW)
#define CM_DRP_LOCATION_INFORMATION (0x0000000E) // LocationInformation REG_SZ property (RW)
#define CM_DRP_PHYSICAL_DEVICE_OBJECT_NAME (0x0000000F) // PhysicalDeviceObjectName REG_SZ property (R)
#define CM_DRP_CAPABILITIES (0x00000010) // Capabilities REG_DWORD property (R)
#define CM_DRP_UI_NUMBER (0x00000011) // UiNumber REG_DWORD property (R)
#define CM_DRP_UPPERFILTERS (0x00000012) // UpperFilters REG_MULTI_SZ property (RW)
#define CM_DRP_LOWERFILTERS (0x00000013) // LowerFilters REG_MULTI_SZ property (RW)
#define CM_DRP_BUSTYPEGUID (0x00000014) // Bus Type Guid, GUID, (R)
#define CM_DRP_LEGACYBUSTYPE (0x00000015) // Legacy bus type, INTERFACE_TYPE, (R)
#define CM_DRP_BUSNUMBER (0x00000016) // Bus Number, DWORD, (R)
#define CM_DRP_ENUMERATOR_NAME (0x00000017) // Enumerator REG_SZ property, (R)
#define CM_DRP_MIN (0x00000001)
#define CM_DRP_MAX (0x00000017)
//
// Capabilities bits (the capability value is returned from calling
// CM_Get_DevInst_Registry_Property with CM_DRP_CAPABILITIES flag)
//
#define CM_DEVCAP_LOCKSUPPORTED (0x00000001)
#define CM_DEVCAP_EJECTSUPPORTED (0x00000002)
#define CM_DEVCAP_REMOVABLE (0x00000004)
#define CM_DEVCAP_DOCKDEVICE (0x00000008)
#define CM_DEVCAP_UNIQUEID (0x00000010)
#define CM_DEVCAP_SILENTINSTALL (0x00000020)
#define CM_DEVCAP_RAWDEVICEOK (0x00000040)
#define CM_DEVCAP_SURPRISEREMOVALOK (0x00000080)
//
// Flags for CM_Locate_DevNode
//
#define CM_LOCATE_DEVNODE_NORMAL 0x00000000
#define CM_LOCATE_DEVNODE_PHANTOM 0x00000001
#define CM_LOCATE_DEVNODE_CANCELREMOVE 0x00000002
#define CM_LOCATE_DEVNODE_NOVALIDATION 0x00000004
#define CM_LOCATE_DEVNODE_BITS 0x00000007
#define CM_LOCATE_DEVINST_NORMAL CM_LOCATE_DEVNODE_NORMAL
#define CM_LOCATE_DEVINST_PHANTOM CM_LOCATE_DEVNODE_PHANTOM
#define CM_LOCATE_DEVINST_CANCELREMOVE CM_LOCATE_DEVNODE_CANCELREMOVE
#define CM_LOCATE_DEVINST_NOVALIDATION CM_LOCATE_DEVNODE_NOVALIDATION
#define CM_LOCATE_DEVINST_BITS CM_LOCATE_DEVNODE_BITS
//
// Flags for CM_Open_Class_Key
//
#define CM_OPEN_CLASS_KEY_INSTALLER (0x00000000)
#define CM_OPEN_CLASS_KEY_INTERFACE (0x00000001)
#define CM_OPEN_CLASS_KEY_BITS (0x00000001)
//
// Remove subtree and Query remove subtree flags
//
#define CM_QUERY_REMOVE_UI_OK 0x00000000
#define CM_QUERY_REMOVE_UI_NOT_OK 0x00000001
#define CM_QUERY_REMOVE_BITS 0x00000001
#define CM_REMOVE_UI_OK 0x00000000
#define CM_REMOVE_UI_NOT_OK 0x00000001
#define CM_REMOVE_BITS 0x00000001
//
// Flags for CM_Reenumerate_DevNode
//
#define CM_REENUMERATE_NORMAL 0x00000000
#define CM_REENUMERATE_SYNCHRONOUS 0x00000001
#define CM_REENUMERATE_BITS 0x00000001
//
// Flags for CM_Register_Device_Driver
//
#define CM_REGISTER_DEVICE_DRIVER_STATIC (0x00000000)
#define CM_REGISTER_DEVICE_DRIVER_DISABLEABLE (0x00000001)
#define CM_REGISTER_DEVICE_DRIVER_REMOVABLE (0x00000002)
#define CM_REGISTER_DEVICE_DRIVER_BITS (0x00000003)
//
// Registry Branch Locations (for CM_Open_DevNode_Key)
//
#define CM_REGISTRY_HARDWARE (0x00000000)
#define CM_REGISTRY_SOFTWARE (0x00000001)
#define CM_REGISTRY_USER (0x00000100)
#define CM_REGISTRY_CONFIG (0x00000200)
#define CM_REGISTRY_BITS (0x00000301)
//
// Flags for CM_Set_DevNode_Problem
//
#define CM_SET_DEVNODE_PROBLEM_NORMAL (0x00000000) // only set problem if currently no problem
#define CM_SET_DEVNODE_PROBLEM_OVERRIDE (0x00000001) // override current problem with new problem
#define CM_SET_DEVNODE_PROBLEM_BITS (0x00000001)
#define CM_SET_DEVINST_PROBLEM_NORMAL CM_SET_DEVNODE_PROBLEM_NORMAL
#define CM_SET_DEVINST_PROBLEM_OVERRIDE CM_SET_DEVNODE_PROBLEM_OVERRIDE
#define CM_SET_DEVINST_PROBLEM_BITS CM_SET_DEVNODE_PROBLEM_BITS
//
// Re-enable and configuration actions (specified in call to CM_Setup_DevInst)
//
#define CM_SETUP_DEVNODE_READY (0x00000000) // Reenable problem devinst
#define CM_SETUP_DEVINST_READY CM_SETUP_DEVNODE_READY
#define CM_SETUP_DOWNLOAD (0x00000001) // Get info about devinst
#define CM_SETUP_WRITE_LOG_CONFS (0x00000002)
#define CM_SETUP_PROP_CHANGE (0x00000003)
#define CM_SETUP_BITS (0x00000003)
//
// Flags for CM_Query_Arbitrator_Free_Data and
// CM_Query_Arbitrator_Free_Data_Size.
//
#define CM_QUERY_ARBITRATOR_RAW (0x00000000)
#define CM_QUERY_ARBITRATOR_TRANSLATED (0x00000001)
#define CM_QUERY_ARBITRATOR_BITS (0x00000001)
//--------------------------------------------------------------
// Function prototypes
//--------------------------------------------------------------
CMAPI
CONFIGRET
WINAPI
CM_Add_Empty_Log_Conf(
OUT PLOG_CONF plcLogConf,
IN DEVINST dnDevInst,
IN PRIORITY Priority,
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -