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


Метод IMDSPDevice::GetName (mswmdm.h)

Метод GetName извлекает имя устройства.

Синтаксис

HRESULT GetName(
  [out] LPWSTR pwszName,
  [in]  UINT   nMaxChars
);

Параметры

[out] pwszName

Указатель на массив из 16-разрядных символов Юникода, который получает строку имени устройства.

[in] nMaxChars

Максимальное число символов для копирования в строку.

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

Метод возвращает HRESULT. Все методы интерфейса в Windows Media диспетчер устройств могут возвращать любой из следующих классов кодов ошибок:

  • Стандартные коды ошибок COM
  • Коды ошибок Windows, преобразованные в значения HRESULT
  • Коды ошибок диспетчер устройств Windows Media
Подробный список возможных кодов ошибок см. в разделе Коды ошибок.

Комментарии

Строковый тип LPWSTR является 16-разрядной строкой символов Юникода и не принимает символы размером байтов. Чтобы преобразовать строку символов размером байтов (LPCSTR) в строку LPWSTR , используйте функцию MultiByteToWideChar , как описано в документации Microsoft Windows.

Имена устройств не должны содержать пробелы в конце.

Этот метод должен быть реализован. Он не должен возвращать WMDM_E_NOTSUPPORTED или E_NOTIMPL. Дополнительные сведения см. в разделе Обязательные и необязательные интерфейсы.

Требования

Требование Значение
Целевая платформа Windows
Header mswmdm.h
Библиотека Mssachlp.lib

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

Интерфейс IMDSPDevice

IMDSPDevice::GetType