IWMDMStorageGlobals::Initialize 方法 (mswmdm.h)

Initialize 方法设置存储介质的格式。

语法

HRESULT Initialize(
  [in] UINT          fuMode,
  [in] IWMDMProgress *pProgress
);

参数

[in] fuMode

用于初始化介质的模式。 指定以下两种模式之一。 如果同时指定了两种模式,则使用块模式。

“模式” 说明
WMDM_MODE_BLOCK 该操作是使用块模式处理执行的。 在操作完成之前,调用不会返回。
WMDM_MODE_THREAD 该操作是使用线程模式处理执行的。 调用将立即返回,操作在后台线程中执行。

[in] pProgress

指向应用程序实现的 IWMDMProgress 接口的指针,用于跟踪格式设置操作的进度。

返回值

该方法返回 HRESULT。 Windows Media 设备管理器 中的所有接口方法都可以返回以下任一类错误代码:

  • 标准 COM 错误代码
  • 转换为 HRESULT 值的 Windows 错误代码
  • Windows Media 设备管理器错误代码
有关可能错误代码的广泛列表,请参阅 错误代码

注解

如果应用程序使用 WMDM_MODE_THREAD 并传递非 null pProgress 参数,则应用程序必须确保在读取操作完成之前不会销毁 pProgress 所属的对象,因为 Windows Media 设备管理器 将向此对象发送进度通知。 此对象只有在收到 结束 通知后才能销毁。 如果不这样做,将导致访问冲突。

要求

要求
目标平台 Windows
标头 mswmdm.h
Library Mssachlp.lib

另请参阅

IWMDMProgress 接口

IWMDMStorageGlobals 接口