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

Метод IMFSensorDevice::GetSymbolicLink (mfidl.h)

  • Статья

Возвращает имя символьной ссылки устройства датчика.

Синтаксис

HRESULT GetSymbolicLink(
  [out] LPWSTR SymbolicLink,
  [in]  LONG   cchSymbolicLink,
  [out] LONG   *pcchWritten
);

Параметры

[out] SymbolicLink

Буфер символов cchSymbolicLink , где будет записано имя символьной ссылки. Буфер должен быть достаточно большим, чтобы учитывать признак конца null.

[in] cchSymbolicLink

Количество символов, доступных в буфере SymbolicLink .

[out] pcchWritten

Выходной параметр, содержащий количество символов, записанных в SymbolicLink. Сюда входит признак конца null. Если значение SymbolicLink равно NULL, а cchSymbolicLink равно 0, pcchWritten будет содержать необходимое количество символов (включая признак конца NULL) для хранения имени символьной ссылки.

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

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
S_OK
 Метод выполнен успешно.
ERROR_INSUFFICIENT_BUFFER
 Буфер, указанный в параметре SymbolicLink , недостаточно велик, чтобы содержать имя символьной ссылки, включая признак конца null.
MF_E_NOT_INITIALIZED
 Устройство датчика не было инициализировано.

Комментарии

В зависимости от типа устройства, который определяется членом перечисления MFSensorDeviceType и может быть получен путем вызова GetDeviceType, полученное символическое имя может быть допустимым символическим именем устройства или URL-адресом поставщика. Вызывающий объект не должен пытаться проанализировать имя и рассматривать его как непрозрачные данные.

Требования

   
Минимальная версия клиента Windows 10 версии 1607 [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header mfidl.h
Библиотека Mfplat.lib; Mfplat.dll

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

IMFSensorDevice