IMDSPStorage：：GetAttributes 方法 (mswmdm.h)

项目
02/29/2024

GetAttributes 方法检索此存储对象的属性。

语法

HRESULT GetAttributes(
  [out] DWORD         *pdwAttributes,
  [out] _WAVEFORMATEX *pFormat
);

参数

[out] pdwAttributes

指向包含 IWMDMStorage：：GetAttributes 方法中定义的属性的 DWORD 的指针。

[out] pFormat

指向 _WAVEFORMATEX 结构的指针，该结构填充了有关对象的特性信息。

返回值

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

标准 COM 错误代码
转换为 HRESULT 值的 Windows 错误代码
Windows Media 设备管理器错误代码

有关可能错误代码的广泛列表，请参阅错误代码。

注解

属性评估是公开媒体设备内容的关键步骤。设备可能不支持在存储媒体上分层存储数据。 GetAttributes 方法允许应用程序通过对象属性发现文件系统的结构来推断文件系统的支持和格式。

例如，顶级 IMDSPStorage 接口的属性指示存储介质， IMDSPEnumStorage 公开媒体的内容。对于 .mp3 文件，属性指示可以通过进一步检查属性和文件名来确定其类型的文件。在分层介质中，属性可以指示其内容可由 IMDSPStorage：：EnumStorage 公开的目录。

_WAVEFORMATEX 参数是可选的。如果将有效的 _WAVEFORMATEX 指针传递给音频文件， GetAttributes 会将描述性信息传递回结构。但是，如果文件不是音频，则会忽略 _WAVEFORMATEX 参数。

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