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

Статья
11/20/2024

Структура 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 может быть пустой строкой.

Замечания

В SetupAPI.hэта структура соответствует SP_DRVINFO_DATA_V1 или SP_DRVINFO_DATA_V2 на основе того, включена ли следующая строка в исходный код:

#define  USE_SP_DRVINFO_DATA_V1 1

Определите этот идентификатор, только если компонент должен работать в 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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.