структура SP_DRVINFO_DATA_V1_A (setupapi.h)

Статья
03/15/2023

Структура SP_DRVINFO_DATA содержит сведения о драйвере. Эта структура является членом списка сведений о драйверах, который может быть связан с конкретным экземпляром устройства или глобально с набором сведений об устройстве.

Синтаксис

typedef struct _SP_DRVINFO_DATA_V1_A {
  DWORD     cbSize;
  DWORD     DriverType;
  ULONG_PTR Reserved;
  CHAR      Description[LINE_LEN];
  CHAR      MfgName[LINE_LEN];
  CHAR      ProviderName[LINE_LEN];
} SP_DRVINFO_DATA_V1_A, *PSP_DRVINFO_DATA_V1_A;

Члены

cbSize

Размер структуры SP_DRVINFO_DATA в байтах. Дополнительные сведения см. в разделе Примечания этой статьи.

DriverType

Тип драйвера, представленного данной структурой. Необходимо установить одно из следующих значений.

SPDIT_CLASSDRIVER

Эта структура представляет драйвер класса.

SPDIT_COMPATDRIVER

Эта структура представляет совместимый драйвер.

Reserved

Зарезервировано. Только для внутреннего использования.

Description[LINE_LEN]

Строка, завершающаяся значением NULL, которая описывает устройство, поддерживаемое этим драйвером.

MfgName[LINE_LEN]

Строка, завершающаяся значением NULL, которая содержит имя производителя устройства, поддерживаемого этим драйвером.

ProviderName[LINE_LEN]

Строка, завершающаяся значением NULL, предоставляющая поставщик этого драйвера. Обычно это имя организации, создающей драйвер или INF-файл. ProviderName может быть пустой строкой.

Этот идентификатор определяется только в том случае, если компонент должен работать в Windows 98 или Millennium Edition или в Windows NT. Если компонент работает только в Windows 2000 и более поздних версиях Windows, не определяйте идентификатор. Если идентификатор не определен, используется SP_DRVINFO_DATA_V2.

SP_DRVINFO_DATA_V1 не содержит элементы DriverDate и DriverVersion .

Функции SetupDiXxx , которые принимают SP_DRVINFO_DATA структуру в качестве параметра, проверяют, что член cbSize предоставленной структуры равен размеру структуры в байтах. Если член cbSize неправильно задан для входного параметра, функция завершится ошибкой и установит код ошибки ERROR_INVALID_PARAMETER. Если член cbSize неправильно задан для выходного параметра, функция завершится ошибкой и установит код ошибки ERROR_INVALID_USER_BUFFER.

Примечание

Заголовок setupapi.h определяет SP_DRVINFO_DATA_V1 как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.