功能

GioVolumeMonitoradopt_orphan_mount

过时:2.20 

声明 [源代码]

GVolume*
g_volume_monitor_adopt_orphan_mount (
  GMount* mount
)

描述 [源代码]

此功能应在任何GVolumeMonitor实现中调用以创建一个不与GVolume对象关联的新GMount对象。它必须在发出mount_added信号之前调用。

如果返回值不是NULL,调用方必须将返回的GVolume对象与GMount相关联。这包括在它的g_mount_get_volume()实现中返回它。调用方还必须监听返回对象的“删除”信号,并在处理该信号时放弃其引用。

类似地,如果实现g_volume_monitor_adopt_orphan_mount(),则实现者必须获取mount的引用并在其g_volume_get_mount()实现中返回它。此外,实现者必须监听mount上的“卸载”信号,并在处理该信号时放弃其引用。

此功能有两个主要用途。

其中一个是在实现用户空间文件系统驱动程序时,该驱动程序读取由本地体积监控器表示的块设备块(例如光盘音频文件系统驱动程序)。这样的驱动程序将生成自己的GMount对象,需要将其与表示卷的GVolume对象关联。

另一个是用于实现其唯一目的是返回代表用户“喜爱服务器”列表条目或类似的GVolumeMonitor

自2.20版本以来已过时

而不是使用此功能,GVolumeMonitor实现应创建要采用的URI的阴影mount。有关此示例,请参阅gvfs中的代理体积监控器。另请参阅g_mount_is_shadowed()g_mount_shadow()g_mount_unshadow()功能。

参数

mount

类型: GMount

要查找其父级的GMount对象。

数据由函数的调用者拥有。

返回值

类型: GVolume

mount的父级的GVolume对象或NULL,如果没有想要采用该GMount

函数的调用者拥有数据,并负责释放它。