структура SP_DEVINFO_DATA (setupapi.h)
Структура SP_DEVINFO_DATA определяет экземпляр устройства, который является членом набора сведений об устройстве.
Синтаксис
typedef struct _SP_DEVINFO_DATA {
DWORD cbSize;
GUID ClassGuid;
DWORD DevInst;
ULONG_PTR Reserved;
} SP_DEVINFO_DATA, *PSP_DEVINFO_DATA;
Члены
cbSize
Размер структуры SP_DEVINFO_DATA в байтах. Дополнительные сведения см. в разделе "Примечания".
ClassGuid
GUID класса установки устройства.
DevInst
Непрозрачный дескриптор экземпляра устройства (также известный как дескриптор devnode).
Некоторые функции, такие как функции SetupDiXxx , принимают всю структуру SP_DEVINFO_DATA в качестве входных данных для идентификации устройства в наборе сведений об устройстве. Другие функции, такие как функции CM_Xxx , такие как CM_Get_DevNode_Status, принимают этот дескриптор DevInst в качестве входных данных.
Reserved
Зарезервировано. Только для внутреннего использования.
Комментарии
Структура SP_DEVINFO_DATA определяет устройство в наборе сведений об устройствах. Например, когда Windows отправляет запрос DIF_INSTALLDEVICE установщику класса и совместному установщику, он включает дескриптор набора сведений об устройстве и указатель на SP_DEVINFO_DATA, указывающий конкретное устройство. Помимо запросов DIF, эта структура также используется в некоторых функциях SetupDiXxx .
Функции SetupDiXxx, которые принимают структуру SP_DEVINFO_DATA в качестве параметра, проверяют, что член cbSize предоставленной структуры равен размеру структуры в байтах. Если член cbSize неправильно задан для входного параметра, функция завершится ошибкой и задаст код ошибки ERROR_INVALID_PARAMETER. Если член cbSize неправильно задан для выходного параметра, функция завершится ошибкой и задаст код ошибки ERROR_INVALID_USER_BUFFER.
Требования
| Верхняя часть | setupapi.h (включая Setupapi.h) |