Функция SetupDiGetDeviceInstanceIdA (setupapi.h)

Статья
11/20/2024

Функция SetupDiGetDeviceInstanceId извлекает идентификатор экземпляра устройства , связанный с элементом сведений об устройстве.

Заметка

В Windows Vista и более поздних версиях Windows модель унифицированных свойств устройства использует ключ свойства DEVPKEY_Device_InstanceId для представления идентификатора экземпляра устройства. Дополнительные сведения см. в получении идентификатора экземпляра устройства.

Синтаксис

WINSETUPAPI BOOL SetupDiGetDeviceInstanceIdA(
  [in]            HDEVINFO         DeviceInfoSet,
  [in]            PSP_DEVINFO_DATA DeviceInfoData,
  [out, optional] PSTR             DeviceInstanceId,
  [in]            DWORD            DeviceInstanceIdSize,
  [out, optional] PDWORD           RequiredSize
);

Параметры

[in] DeviceInfoSet

Дескриптор набора сведений об устройстве , который содержит элемент сведений об устройстве, представляющий устройство, для которого требуется получить идентификатор экземпляра устройства.

[in] DeviceInfoData

Указатель на структуру SP_DEVINFO_DATA, указывающую элемент сведений об устройстве в DeviceInfoSet.

[out, optional] DeviceInstanceId

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

[in] DeviceInstanceIdSize

Размер в символах буфера deviceInstanceId .

[out, optional] RequiredSize

Указатель на переменную, которая получает количество символов, необходимых для хранения идентификатора экземпляра устройства.

Возвращаемое значение

Функция возвращает TRUE, если она выполнена успешно. В противном случае возвращается FALSE и ошибка журнала может быть получена путем вызова GetLastError.

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
целевая платформа	Настольный
заголовка	setupapi.h (include Setupapi.h)
библиотеки	Setupapi.lib

См. также

SP_DEVINFO_DATA

SetupDiCreateDevRegKey

SetupDiCreateDeviceInfo

SetupDiOpenDevRegKey

SetupDiOpenDeviceInfo

Поделиться через