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。调用方不应尝试分析名称，应将其视为不透明数据。