IMDSPStorageGlobals：：Initialize 方法 (mswmdm.h)

  • 项目

Initialize 方法格式化存储介质。 此方法是可选的。 但是，如果设备支持此功能，则应实现此方法。 如果未实现此方法，则除了任何其他标志外， IMDSPStorageGlobals：：GetCapabilities 还必须返回WMDM_STORAGECAP_NOT_INITIALIZABLE。 有关详细信息，请参阅 必需接口和可选接口。

语法

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

参数

[in] fuMode

用于初始化介质的模式。 请指定以下两种模式之一。 如果同时指定这两种模式，则使用阻止模式。

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

[in] pProgress

指向由应用程序实现的 IWMDMProgress 接口的指针，用于跟踪格式设置操作的进度。 此参数可以为 NULL。

返回值

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

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

注解

如果指定了WMDM_MODE_BLOCK，则在完成格式设置之前， Initialize 不会返回。 如果指定了WMDM_MODE_THREAD，调用将立即返回，调用方可以使用 IMDSPStorageGlobals：：GetStatus 方法跟踪初始化操作。

要求

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

另请参阅

IMDSPStorageGlobals 接口

IMDSPStorageGlobals：：GetCapabilities

IMDSPStorageGlobals：：GetStatus

IWMDMProgress 接口