IMDSPStorage：：GetAttributes 方法 (mswmdm.h)

發行項
02/29/2024

GetAttributes 方法會擷取這個記憶體物件的屬性。

語法

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

參數

[out] pdwAttributes

DWORD 的指標，其中包含 IWMDMStorage：：GetAttributes 方法中所定義的屬性。

[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。如需詳細資訊，請參閱強制和選擇性介面。