функция CM_Get_Device_Interface_List_SizeW (cfgmgr32.h)

Статья
08/22/2023

Функция CM_Get_Device_Interface_List_Size извлекает размер буфера, который должен быть передан функции CM_Get_Device_Interface_List .

Синтаксис

CMAPI CONFIGRET CM_Get_Device_Interface_List_SizeW(
  [out]          PULONG      pulLen,
  [in]           LPGUID      InterfaceClassGuid,
  [in, optional] DEVINSTID_W pDeviceID,
  [in]           ULONG       ulFlags
);

Параметры

[out] pulLen

Поставляемый вызывающим объектом указатель на расположение, которое получает необходимую длину (в символах) буфера для хранения нескольких строк Юникода, которые будут возвращены CM_Get_Device_Interface_List.

[in] InterfaceClassGuid

Предоставляет GUID, идентифицирующий класс интерфейса устройства.

[in, optional] pDeviceID

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

[in] ulFlags

Содержит один из следующих флагов, предоставленных вызывающей стороны:

Значение	Значение
CM_GET_DEVICE_INTERFACE_LIST_ALL_DEVICES	Функция предоставляет размер списка, содержащего интерфейсы устройств, связанные со всеми устройствами, которые соответствуют указанному GUID и идентификатору экземпляра устройства, если таковые есть.
CM_GET_DEVICE_INTERFACE_LIST_PRESENT	Функция предоставляет размер списка, содержащего интерфейсы устройств, связанные с текущими активными устройствами и соответствующие указанному ИДЕНТИФИКАТОРу GUID и идентификатору экземпляра устройства, если таковые имеются.

Значение

CM_GET_DEVICE_INTERFACE_LIST_ALL_DEVICES

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

CM_GET_DEVICE_INTERFACE_LIST_PRESENT

Функция предоставляет размер списка, содержащего интерфейсы устройств, связанные с текущими активными устройствами и соответствующие указанному ИДЕНТИФИКАТОРу GUID и идентификатору экземпляра устройства, если таковые имеются.

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

Если операция выполнена успешно, функция возвращает CR_SUCCESS. В противном случае возвращается один из кодов ошибок с префиксом CR_ , как определено в Cfgmgr32.h.

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

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
Целевая платформа	Универсальное
Верхняя часть	cfgmgr32.h (включая Cfgmgr32.h)
Библиотека	Cfgmgr32.lib
DLL	CfgMgr32.dll

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

CM_Get_Device_Interface_List