IMDSPStorage::GetAttributes メソッド (mswmdm.h)
GetAttributes メソッドは、このストレージ オブジェクトの属性を取得します。
構文
HRESULT GetAttributes(
[out] DWORD *pdwAttributes,
[out] _WAVEFORMATEX *pFormat
);
パラメーター
[out] pdwAttributes
IWMDMStorage::GetAttributes メソッドで定義されている属性を含む DWORD へのポインター。
[out] pFormat
オブジェクトに関する属性情報が格納されている _WAVEFORMATEX 構造体へのポインター。
戻り値
このメソッドは、HRESULTを返します。 Windows Media Device Manager のすべてのインターフェイス メソッドは、次のいずれかのクラスのエラー コードを返すことができます。
- 標準の COM エラー コード
- HRESULT 値に変換された Windows エラー コード
- Windows Media Device Manager のエラー コード
備考
属性の評価は、メディア デバイスのコンテンツを公開する際に重要な手順です。 デバイスは、ストレージ メディア上のデータの階層型ストレージをサポートしていない場合があります。 GetAttributes メソッドを使用すると、アプリケーションはオブジェクト属性を使用してその構造を検出することによって、ファイル システムのサポートと形式を推測できます。
たとえば、最上位 IMDSPStorage インターフェイスの属性はストレージ メディアを示し、IMDSPEnumStorage はメディアの内容を公開します。 .mp3 ファイルの場合、属性は、属性とファイル名の両方を詳しく調べることで型を決定できるファイルを示します。 階層的なメディアでは、属性は、IMDSPStorage::EnumStorage によってコンテンツ公開できるディレクトリを示すことができます。
_WAVEFORMATEX パラメーターは省略可能です。 有効な _WAVEFORMATEX ポインターをオーディオ ファイルに渡すと、GetAttributes 記述情報が構造体に戻されます。 ただし、ファイルがオーディオでない場合、_WAVEFORMATEX パラメーターは無視されます。
このメソッドを実装する必要があります。 WMDM_E_NOTSUPPORTEDまたはE_NOTIMPLを返してはなりません。 詳細については、「必須インターフェイスとオプション インターフェイス 」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | ウィンドウズ |
| ヘッダー | mswmdm.h |
| ライブラリ | Mssachlp.lib |