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

Статья
08/24/2023

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

Синтаксис

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

Share via