SP_DRVINFO_DETAIL_DATA_A structure (setupapi.h)
An SP_DRVINFO_DETAIL_DATA structure contains detailed information about a particular driver information structure.
Syntax
typedef struct _SP_DRVINFO_DETAIL_DATA_A {
DWORD cbSize;
FILETIME InfDate;
DWORD CompatIDsOffset;
DWORD CompatIDsLength;
ULONG_PTR Reserved;
CHAR SectionName[LINE_LEN];
CHAR InfFileName[MAX_PATH];
CHAR DrvDescription[LINE_LEN];
CHAR HardwareID[ANYSIZE_ARRAY];
} SP_DRVINFO_DETAIL_DATA_A, *PSP_DRVINFO_DETAIL_DATA_A;
Members
cbSize
The size, in bytes, of the SP_DRVINFO_DETAIL_DATA structure.
InfDate
Date of the INF file for this driver.
CompatIDsOffset
The offset, in characters, from the beginning of the HardwareID buffer where the CompatIDs list begins.
This value can also be used to determine whether there is a hardware ID that precedes the CompatIDs list. If this value is greater than 1, the first string in the HardwareID buffer is the hardware ID. If this value is less than or equal to 1, there is no hardware ID.
CompatIDsLength
The length, in characters, of the CompatIDs list starting at offset CompatIDsOffset from the beginning of the HardwareID buffer.
If CompatIDsLength is nonzero, the CompatIDs list contains one or more NULL-terminated strings with an additional NULL character at the end of the list.
If CompatIDsLength is zero, the CompatIDs list is empty. In that case, there is no additional NULL character at the end of the list.
Reserved
Reserved. For internal use only.
SectionName[LINE_LEN]
A NULL-terminated string that contains the name of the INF DDInstall section for this driver. This must be the basic DDInstall section name, such as InstallSec, without any OS/architecture-specific extensions.
InfFileName[MAX_PATH]
A NULL-terminated string that contains the full-qualified name of the INF file for this driver.
DrvDescription[LINE_LEN]
A NULL-terminated string that describes the driver.
HardwareID[ANYSIZE_ARRAY]
A buffer that contains a list of IDs (a single hardware ID followed by a list of compatible IDs). These IDs correspond to the hardware ID and compatible IDs in the INF Models section.
Each ID in the list is a NULL-terminated string.
If the hardware ID exists (that is, if CompatIDsOffset is greater than one), this single NULL-terminated string is found at the beginning of the buffer.
If the CompatIDs list is not empty (that is, if CompatIDsLength is not zero), the CompatIDs list starts at offset CompatIDsOffset from the beginning of this buffer, and is terminated with an additional NULL character at the end of the list.
Remarks
The hardware ID and compatible IDs for a device are specified in the INF Models section in the following order:
- The first ID (if specified) is the hardware ID for the device.
- The remaining IDs (if specified) are compatible IDs for the device.
For example, depending on how the list of hardware ID and compatible IDs are specified in the INF Models section, the HardwareID buffer can resemble any of the following:
- \0
- <HWID>\0
- <HWID>\0<COMPATID_1>\0...<COMPATID_N>\0\0
- \0<COMPATID_1>\0...<COMPATID_N>\0\0
// parse the hardware ID, if it exists
if (CompatIDsOffset > 1)
{
// Parse for hardware ID from index 0.
// This is a single NULL-terminated string
}
// Parse the compatible IDs, if they exist
if (CompatIDsLength > 0)
{
// Parse for list of compatible IDs from CompatIDsOffset.
// This is a double NULL-terminated list of strings (i.e. MULTI-SZ)
}
Note
The setupapi.h header defines SP_DRVINFO_DETAIL_DATA as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
| Requirement | Value |
|---|---|
| Header | setupapi.h (include Setupapi.h) |