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

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

Синтаксис

CMAPI CONFIGRET CM_Get_Device_Interface_AliasW(
  [in]      LPCWSTR pszDeviceInterface,
  [in]      LPGUID  AliasInterfaceGuid,
  [out]     LPWSTR  pszAliasDeviceInterface,
  [in, out] PULONG  pulLength,
  [in]      ULONG   ulFlags
);

Параметры

[in] pszDeviceInterface

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

[in] AliasInterfaceGuid

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

[out] pszAliasDeviceInterface

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

Требуется буфер. В противном случае вызов завершится ошибкой.

[in, out] pulLength

Предоставляет количество символов в pszAliasDeviceInterface и получает количество символов, необходимое для хранения интерфейса псевдонима устройства.

Для входных данных этот параметр должен быть больше 0.

[in] ulFlags

Зарезервировано. Не используется.

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

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

Комментарии

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

Параметр pszDeviceInterface указывает экземпляр интерфейса устройства для конкретного устройства, принадлежащий к определенному классу интерфейса, с определенной ссылочной строкой. CM_Get_Device_Interface_Alias возвращает другой экземпляр интерфейса устройства для того же устройства и ссылочной строки, но другого класса интерфейса, если он существует.

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

Два интерфейса устройства со строками ссылок NULL являются псевдонимами, если они предоставляются тем же базовым устройством и имеют разные GUID класса интерфейса.

Требования