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::GetCapabilities