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

  • Статья

Функция 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 (включая Setupapi.h)
Библиотека Setupapi.lib

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

SP_DEVINFO_DATA

SetupDiCreateDevRegKey

SetupDiCreateDeviceInfo

SetupDiOpenDevRegKey

SetupDiOpenDeviceInfo