структура 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)

См. также раздел

SP_DEVINFO_LIST_DETAIL_DATA