IMDSPStorage::GetAttributes メソッド (mswmdm.h)

[アーティクル]
03/05/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を返してはなりません。詳細については、「必須インターフェイスとオプションインターフェイス」を参照してください。