IMDSPStorageGlobals::GetCapabilities メソッド (mswmdm.h)

GetCapabilities メソッドは、このインターフェイスのインスタンスが関連付けられているストレージ メディアの機能を取得します。

構文

HRESULT GetCapabilities(
  [out] DWORD *pdwCapabilities
);

パラメーター

[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 インターフェイス