imDSPStorage：：CreateStorage 方法 (mswmdm.h)
CreateStorage 方法创建一个新存储，并返回指向新创建的存储上的 IMDSPStorage 接口的指针。 此方法是可选的，除非WMDM_FILE_ATTR_FILE dwAttributes 。 在这种情况下，必须实现此方法，并且不得返回WMDM_E_NOTSUPPORTED或E_NOTIMPL。 有关详细信息，请参阅 必需接口和可选接口。
语法
HRESULT CreateStorage(
[in] DWORD dwAttributes,
[in] _WAVEFORMATEX *pFormat,
[in] LPWSTR pwszName,
[out] IMDSPStorage **ppNewStorage
);
参数
[in] dwAttributes
包含新存储的属性的 DWORD。 下表列出了可用的存储属性。
| Attribute | 说明 |
|---|---|
| WMDM_STORAGECONTROL_INSERTBEFORE | 将在目标对象的前面创建新的存储对象。 |
| WMDM_STORAGECONTROL_INSERTAFTER | 将在目标对象之后创建新的存储对象。 |
| WMDM_STORAGECONTROL_INSERTINTO | 将在目标对象文件夹中创建新的存储对象。 |
| WMDM_STORAGECONTROL_OVERWRITE | 如果已存在同名的存储，则会销毁该存储并创建一个新存储。 |
| WMDM_STORAGE_ATTR_FILESYSTEM | 此对象是顶级存储介质 (例如存储卡或其他一些板载存储。) |
| WMDM_STORAGE_ATTR_REMOVABLE | 此存储介质是可移动的。 |
| WMDM_STORAGE_ATTR_CANEDITMETADATA | 此存储可以编辑元数据。 |
| WMDM_STORAGE_ATTR_FOLDERS | 此存储介质支持文件夹和文件层次结构。 |
| WMDM_FILE_ATTR_FOLDER | 这是存储介质上的文件夹。 |
| WMDM_FILE_ATTR_LINK | 这是一个链接，用于在多个文件之间创建关联。 |
| WMDM_FILE_ATTR_FILE | 这是存储介质上的文件。 |
| WMDM_FILE_ATTR_AUDIO | 此文件是音频数据。 |
| WMDM_FILE_ATTR_DATA | 此文件是非音频数据。 |
| WMDM_FILE_ATTR_CANPLAY | 此音频文件可由设备播放。 |
| WMDM_FILE_ATTR_CANDELETE | 可以删除此文件。 |
| WMDM_FILE_ATTR_CANMOVE | 可以在存储介质上移动此文件或文件夹。 |
| WMDM_FILE_ATTR_CANRENAME | 可以重命名此文件或文件夹。 |
| WMDM_FILE_ATTR_CANREAD | 此文件可由主计算机读取。 |
| WMDM_FILE_ATTR_MUSIC | 此音频文件是音乐。 |
| WMDM_FILE_ATTR_VIDEO | 此文件包含视频数据。 |
| WMDM_FILE_ATTR_HIDDEN | 此文件隐藏在文件系统上 |
| WMDM_FILE_ATTR_SYSTEM | 这是一个系统文件 |
| WMDM_FILE_ATTR_READONLY | 这是一个只读文件。 |
| WMDM_STORAGE_IS_DEFAULT | 此存储是应放置新媒体的默认存储。 |
| WMDM_STORAGE_CONTAINS_DEFAULT | 此存储包含应放置新媒体的默认存储。 |
[in] pFormat
指向包含有关对象信息的 _WAVEFORMATEX 结构的指针（如果对象是音频文件）。
[in] pwszName
指向以 null 结尾的宽字符字符串的指针，该字符串包含新存储的名称。
[out] ppNewStorage
指向 IMDSPStorage 指针的指针，用于接收新创建的存储的 IMDSPStorage 接口。
返回值
该方法返回 HRESULT。 Windows Media 设备管理器 中的所有接口方法都可以返回以下任一类错误代码：
- 标准 COM 错误代码
- 转换为 HRESULT 值的 Windows 错误代码
- Windows Media 设备管理器错误代码
注解
如果同时设置了WMDM_FILE_ATTR_FOLDER和WMDM_FILE_ATTR_FILE属性，则文件夹属性将替代文件属性，并将新存储创建为文件夹。
客户端只能指定WMDM_STORAGECONTROL_INSERTBEFORE、WMDM_STORAGECONTROL_INSERTAFTER和WMDM_STORAGECONTROL_INSERTINTO之一。
可以在同一级别创建新存储，也可以插入到当前存储中，前提是当前存储是一个文件夹。 这由 dwAttributes 参数的值控制。 如果指定WMDM_STORAGECONTROL_INSERTBEFORE或WMDM_STORAGECONTROL_INSERTAFTER，则会在与当前存储相同的级别创建新存储。 如果指定WMDM_STORAGECONTROL_INSERTINTO，则新存储将插入到当前存储中。
WMDM_STORAGECONTROL_INSERTBEFORE和WMDM_STORAGECONTROL_INSERAFTER意味着对文件系统中的内容进行排序。 例如，如果文件系统不支持 (排序，则 FAT32) 这两个标志具有相同的效果，即在当前存储的同一级别插入新存储。 如果当前存储表示存储介质的根，并且指定了这两个标志之一，则操作将失败。
仅当当前存储为文件夹时，WMDM_STORAGECONTROL_INSERTINTO才有效。 如果当前存储是文件，并且指定了此标志，则操作将失败。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | mswmdm.h |
| Library | Mssachlp.lib |