Share via

IMDSPStorageGlobals：：GetCapabilities 方法 (mswmdm.h)

  • 项目

GetCapabilities 方法检索与此接口的实例关联的存储介质的功能。

语法

HRESULT GetCapabilities(
  [out] DWORD *pdwCapabilities
);

parameters

[out] pdwCapabilities

指向包含存储介质功能的 DWORD 的指针。

可以在 pdwCapabilities 参数中返回以下标志。

标志 描述
WMDM_STORAGECAP_FOLDERSINROOT 介质支持存储根目录中的文件夹。
WMDM_STORAGECAP_FILESINROOT 介质支持存储根目录中的文件。
WMDM_STORAGECAP_FOLDERSINFOLDERS 媒体支持文件夹中的文件夹。
WMDM_STORAGECAP_FILESINFOLDERS 媒体支持文件夹中的文件。
WMDM_STORAGECAP_FOLDERLIMITEXISTS 媒体对每个文件夹支持形式允许的文件夹数有任意计数限制。
WMDM_STORAGECAP_FILELIMITEXISTS 媒体对每个文件支持形式允许的文件数有任意计数限制。
WMDM_STORAGECAP_NOT_INITIALIZABLE 无法初始化介质。 默认情况下，可以初始化顶级存储。
 

对于受保护的设备实现，还可以返回描述媒体权限功能的以下标志。

标志 描述
WMDM_RIGHTS_PLAYBACKCOUNT 媒体支持内容的播放计数限制。
WMDM_RIGHTS_EXPIRATIONDATE 媒体支持内容的过期日期跟踪。
WMDM_RIGHTS_FREESERIALIDS 媒体支持文件的可用串行标识符。
WMDM_RIGHTS_GROUPID 媒体支持文件的组标识符。
WMDM_RIGHTS_NAMEDSERIALIDS 媒体支持文件的命名串行标识符。

返回值

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

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

注解

尝试使用 IMDSPObject 接口对存储介质执行不受支持的操作会返回错误代码。 可以调用 GetCapabilities 方法以确定操作是否预期在正常情况下会成功。

如果WMDM_STORAGECAP_FILELIMITEXISTS标志或WMDM_STORAGECAP_FOLDERLIMITEXISTS标志为 true，则可创建的文件或文件夹数存在任意限制。 通过 IMDSPObject 接口进行的超出这些限制的操作将失败。

必须实现此方法。 它不得返回WMDM_E_NOTSUPPORTED或E_NOTIMPL。 有关详细信息，请参阅 必需接口和可选接口。

要求

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

请参阅

IMDSPStorageGlobals 接口