功能
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
。
函数的调用者拥有数据,并负责释放它。 |