接口

描述 [源代码]

interface Gio.Drive : GObject.Object

GDrive 表示连接到机器的硬件设备。它通常仅用于可移动硬件或具有可移动媒体的硬件。例如，光驱或 USB 闪存驱动器。

GDrive是一个用于从相同媒体来源的GVolume对象的容器类别。因此，GDrive抽象了一个带（或不带）可移动媒体的光驱，并提供查询媒体是否可用、确定是否自动检测到媒体更改以及弹出媒体的操作。

如果GDrive报告媒体无法自动检测，可以轮询媒体；通常不应该定期这样做，因为媒体轮询操作可能很昂贵，并可能使驱动器产生噪音。

GDrive支持带有前方认证支持的启动和停止驱动器。这可以用来支持各种使用场景，包括连接/断开iSCSI设备、关闭外部磁盘托架以及启动/停止多磁盘设备（如RAID设备）。请注意，启动/停止GDrive的实际语义和副作用可能因实现而异。要在文件管理器等中选取正确的动词，请使用g_drive_get_start_stop_type()。

对于从GnomeVFS迁移的情况，请注意，在那个API中没有与GDrive相当的类。

前提条件

为了实现驱动器，您的类型必须继承自GObject。

接口结构

struct GioDriveIface {
  GTypeInterface g_iface;
  void (* changed) (
    GDrive* drive
  );
  void (* disconnected) (
    GDrive* drive
  );
  void (* eject_button) (
    GDrive* drive
  );
  char* (* get_name) (
    GDrive* drive
  );
  GIcon* (* get_icon) (
    GDrive* drive
  );
  gboolean (* has_volumes) (
    GDrive* drive
  );
  GList* (* get_volumes) (
    GDrive* drive
  );
  gboolean (* is_media_removable) (
    GDrive* drive
  );
  gboolean (* has_media) (
    GDrive* drive
  );
  gboolean (* is_media_check_automatic) (
    GDrive* drive
  );
  gboolean (* can_eject) (
    GDrive* drive
  );
  gboolean (* can_poll_for_media) (
    GDrive* drive
  );
  void (* eject) (
    GDrive* drive,
    GMountUnmountFlags flags,
    GCancellable* cancellable,
    GAsyncReadyCallback callback,
    gpointer user_data
  );
  gboolean (* eject_finish) (
    GDrive* drive,
    GAsyncResult* result,
    GError** error
  );
  void (* poll_for_media) (
    GDrive* drive,
    GCancellable* cancellable,
    GAsyncReadyCallback callback,
    gpointer user_data
  );
  gboolean (* poll_for_media_finish) (
    GDrive* drive,
    GAsyncResult* result,
    GError** error
  );
  char* (* get_identifier) (
    GDrive* drive,
    const char* kind
  );
  char** (* enumerate_identifiers) (
    GDrive* drive
  );
  GDriveStartStopType (* get_start_stop_type) (
    GDrive* drive
  );
  gboolean (* can_start) (
    GDrive* drive
  );
  gboolean (* can_start_degraded) (
    GDrive* drive
  );
  void (* start) (
    GDrive* drive,
    GDriveStartFlags flags,
    GMountOperation* mount_operation,
    GCancellable* cancellable,
    GAsyncReadyCallback callback,
    gpointer user_data
  );
  gboolean (* start_finish) (
    GDrive* drive,
    GAsyncResult* result,
    GError** error
  );
  gboolean (* can_stop) (
    GDrive* drive
  );
  void (* stop) (
    GDrive* drive,
    GMountUnmountFlags flags,
    GMountOperation* mount_operation,
    GCancellable* cancellable,
    GAsyncReadyCallback callback,
    gpointer user_data
  );
  gboolean (* stop_finish) (
    GDrive* drive,
    GAsyncResult* result,
    GError** error
  );
  void (* stop_button) (
    GDrive* drive
  );
  void (* eject_with_operation) (
    GDrive* drive,
    GMountUnmountFlags flags,
    GMountOperation* mount_operation,
    GCancellable* cancellable,
    GAsyncReadyCallback callback,
    gpointer user_data
  );
  gboolean (* eject_with_operation_finish) (
    GDrive* drive,
    GAsyncResult* result,
    GError** error
  );
  const gchar* (* get_sort_key) (
    GDrive* drive
  );
  GIcon* (* get_symbolic_icon) (
    GDrive* drive
  );
  gboolean (* is_removable) (
    GDrive* drive
  );
  
}

用于创建 GDrive 实现的接口。

接口成员

`g_iface`	`GTypeInterface`
	父接口。
`changed`	`void (* changed) ( GDrive* drive )`
	当驱动器发生变化时发出的信号。
`disconnected`	`void (* disconnected) ( GDrive* drive )`
	当 `GDrive` 已断开连接时发出的移除信号。如果接收者持有对该对象的引用，则应释放它们，以便对象可以完成。
`eject_button`	`void (* eject_button) ( GDrive* drive )`
	当驱动器的物理弹出按钮（如果有）被按下时发出。
`get_name`	`char* (* get_name) ( GDrive* drive )`
	返回给定 `GDrive` 的名称。
`get_icon`	`GIcon* (* get_icon) ( GDrive* drive )`
	返回给定 `GDrive` 的 `GIcon`。
`has_volumes`	`gboolean (* has_volumes) ( GDrive* drive )`
	如果 `GDrive` 有可安装卷返回 `TRUE`。
`get_volumes`	`GList* (* get_volumes) ( GDrive* drive )`
	返回包含 `GDrive` 的 `GVolume` 的 `GList` 列表。
`is_media_removable`	`gboolean (* is_media_removable) ( GDrive* drive )`
	如果 `GDrive` 支持媒体的移除和插入返回 `TRUE`。
`has_media`	`gboolean (* has_media) ( GDrive* drive )`
	如果 `GDrive` 已插入媒体返回 `TRUE`。
`is_media_check_automatic`	`gboolean (* is_media_check_automatic) ( GDrive* drive )`
	如果 `GDrive` 能够自动检测媒体更改返回 `TRUE`。
`can_eject`	`gboolean (* can_eject) ( GDrive* drive )`
	如果 `GDrive` 可以弹出媒体返回 `TRUE`。
`can_poll_for_media`	`gboolean (* can_poll_for_media) ( GDrive* drive )`
	如果 `GDrive` 能够手动轮询媒体更改返回 `TRUE`。
`eject`	`void (* eject) ( GDrive* drive, GMountUnmountFlags flags, GCancellable* cancellable, GAsyncReadyCallback callback, gpointer user_data )`
	弹出 `GDrive`。
`eject_finish`	`gboolean (* eject_finish) ( GDrive* drive, GAsyncResult* result, GError** error )`
	完成弹出操作。
`poll_for_media`	`void (* poll_for_media) ( GDrive* drive, GCancellable* cancellable, GAsyncReadyCallback callback, gpointer user_data )`
	在 `GDrive` 上轮询媒体插入/移除。
`poll_for_media_finish`	`gboolean (* poll_for_media_finish) ( GDrive* drive, GAsyncResult* result, GError** error )`
	完成媒体轮询操作。
`get_identifier`	`char* (* get_identifier) ( GDrive* drive, const char* kind )`
	返回给定种类的标识符，如果 `GDrive` 没有标识符返回 `NULL`。
`enumerate_identifiers`	`char** (* enumerate_identifiers) ( GDrive* drive )`
	返回包含 `GDrive` 所具有的标识符种类的字符串数组。
`get_start_stop_type`	`GDriveStartStopType (* get_start_stop_type) ( GDrive* drive )`
	获取表示启动/停止驱动器详细信息的 `GDriveStartStopType`。自 2.22。
`can_start`	`gboolean (* can_start) ( GDrive* drive )`
	如果可以启动 `GDrive` 返回 `TRUE`。自 2.22。
`can_start_degraded`	`gboolean (* can_start_degraded) ( GDrive* drive )`
	如果可以以降级方式启动 `GDrive` 返回 `TRUE`。自 2.22。
`start`	`void (* start) ( GDrive* drive, GDriveStartFlags flags, GMountOperation* mount_operation, GCancellable* cancellable, GAsyncReadyCallback callback, gpointer user_data )`
	启动 `GDrive`。自 2.22。
`start_finish`	`gboolean (* start_finish) ( GDrive* drive, GAsyncResult* result, GError** error )`
	完成启动操作。自 2.22。
`can_stop`	`gboolean (* can_stop) ( GDrive* drive )`
	如果可以停止 `GDrive` 返回 `TRUE`。自 2.22。
`stop`	`void (* stop) ( GDrive* drive, GMountUnmountFlags flags, GMountOperation* mount_operation, GCancellable* cancellable, GAsyncReadyCallback callback, gpointer user_data )`
	停止 `GDrive`。自 2.22。
`stop_finish`	`gboolean (* stop_finish) ( GDrive* drive, GAsyncResult* result, GError** error )`
	完成停止操作。自 2.22。
`stop_button`	`void (* stop_button) ( GDrive* drive )`
	驱动器的物理停止按钮（如有）被按下时发出的信号。自 2.22 版本起。
`eject_with_operation`	`void (* eject_with_operation) ( GDrive* drive, GMountUnmountFlags flags, GMountOperation* mount_operation, GCancellable* cancellable, GAsyncReadyCallback callback, gpointer user_data )`
	使用 `GMountOperation` 开始弹出 `GDrive`。自 2.22 版本起。
`eject_with_operation_finish`	`gboolean (* eject_with_operation_finish) ( GDrive* drive, GAsyncResult* result, GError** error )`
	使用 `GMountOperation` 完成弹出操作。自 2.22 版本起。
`get_sort_key`	`const gchar* (* get_sort_key) ( GDrive* drive )`
	获取用于对 `GDrive` 实例进行排序的键，如果不存在此类键，则返回 `NULL`。自 2.32 版本起。
`get_symbolic_icon`	`GIcon* (* get_symbolic_icon) ( GDrive* drive )`
	为给定的 `GDrive` 返回一个符号性 `GIcon`。自 2.34 版本起。
`is_removable`	`gboolean (* is_removable) ( GDrive* drive )`
	如果用户认为 `GDrive` 和/或其媒体是可移动的，则返回 `TRUE`。自 2.50 版本起。

描述 [源代码]

前提条件

实例方法

信号

接口结构

接口成员

虚函数