IMDSPStorage4::CreateStorageWithMetadata メソッド (mswmdm.h)

[アーティクル]
02/29/2024

CreateStorageWithMetadata メソッドは、指定されたメタデータを新しいストレージに適用して新しいストレージを作成し、新しく作成されたストレージの IMDSPStorage インターフェイスへのポインターを返します。新しいストレージは、同じレベルで作成することも、現在のストレージに挿入することもできます。

このメソッドは、作成時にデバイスにメタデータが必要な場合に便利です。デバイスによっては、ストレージを作成してからメタデータを設定するのではなく、作成時にメタデータを適用する方が効率的な場合もあります。

構文

HRESULT CreateStorageWithMetadata(
  [in]  DWORD         dwAttributes,
  [in]  LPCWSTR       pwszName,
  [in]  IWMDMMetaData *pMetadata,
  [in]  ULONGLONG     qwFileSize,
  [out] IMDSPStorage  **ppNewStorage
);

パラメーター

[in] dwAttributes

新しいストレージの属性を含む DWORD。次の表に、使用可能なストレージ属性の一覧を示します。

属性	説明
WMDM_STORAGECONTROL_INSERTBEFORE	新しいストレージオブジェクトは、ターゲットオブジェクトの前に作成されます。
WMDM_STORAGECONTROL_INSERTAFTER	新しいストレージオブジェクトは、ターゲットオブジェクトの後に作成されます。
WMDM_STORAGECONTROL_INSERTINTO	新しいストレージオブジェクトがターゲットオブジェクトフォルダーに作成されます。
WMDM_STORAGECONTROL_OVERWRITE	同じ名前のストレージが既に存在する場合は、破棄され、新しいストレージが作成されます。
WMDM_STORAGE_ATTR_FILESYSTEM	このオブジェクトは、最上位のストレージメディア (ストレージカードやその他のオンボードストレージなど) です。
WMDM_STORAGE_ATTR_REMOVABLE	この記憶媒体は取り外し可能である。
WMDM_STORAGE_ATTR_CANEDITMETADATA	このストレージでは、メタデータを編集できます。
WMDM_STORAGE_ATTR_FOLDERS	このストレージメディアは、フォルダーとファイル階層をサポートします。
WMDM_FILE_ATTR_FOLDER	これは、ストレージメディア上のフォルダーです。
WMDM_FILE_ATTR_LINK	これは、複数のファイル間の関連付けを作成するリンクです。
WMDM_FILE_ATTR_FILE	これは、ストレージメディア上のファイルです。
WMDM_FILE_ATTR_AUDIO	このファイルはオーディオデータです。
WMDM_FILE_ATTR_DATA	このファイルはオーディオ以外のデータです。
WMDM_FILE_ATTR_CANPLAY	このオーディオファイルは、デバイスで再生できます。
WMDM_FILE_ATTR_CANDELETE	このファイルは削除できます。
WMDM_FILE_ATTR_CANMOVE	このファイルまたはフォルダーは、ストレージメディア上で移動できます。
WMDM_FILE_ATTR_CANRENAME	このファイルまたはフォルダーの名前を変更できます。
WMDM_FILE_ATTR_CANREAD	このファイルは、ホストコンピューターによって読み取ることができます。
WMDM_FILE_ATTR_MUSIC	このオーディオファイルは音楽です。
WMDM_FILE_ATTR_PLAYLIST	これはプレイリストオブジェクトです。
WMDM_FILE_ATTR_VIDEO	このファイルにはビデオデータが含まれています。
WMDM_FILE_ATTR_HIDDEN	このファイルは、ファイルシステムでは非表示になります。
WMDM_FILE_ATTR_SYSTEM	これはシステムファイルです。
WMDM_FILE_ATTR_READONLY	これは読み取り専用ファイルです。
WMDM_STORAGE_IS_DEFAULT	このストレージは、新しいメディアを配置する必要がある既定のストレージです。
WMDM_STORAGE_CONTAINS_DEFAULT	このストレージには、新しいメディアを配置する必要がある既定のストレージが含まれています。

[in] pwszName

新しいストレージの名前を含むワイド文字の null で終わる文字列へのポインター。

[in] pMetadata

IWMDMMetaData インターフェイスへのポインター。

[in] qwFileSize

ファイルサイズを含む Qword。

[out] ppNewStorage

新しく作成されたストレージの IMDSPStorage インターフェイスを受信するための IMDSPStorage ポインターへのポインター。

戻り値

このメソッドは HRESULT を返します。 Windows Media デバイスマネージャーのすべてのインターフェイスメソッドは、次のいずれかのエラーコードクラスを返すことができます。

標準 COM エラーコード
HRESULT 値に変換された Windows エラーコード
Windows Media デバイスマネージャーエラーコード

考えられるエラーコードの詳細な一覧については、「エラーコード」を参照してください。

注釈

このメソッドは、作成時にメタデータをストレージに適用する必要がある場合に便利です。これに対し、 IMDSPStorage2::CreateStorage2 メソッドと IMDSPStorage::CreateStorage メソッドは、作成時にメタデータを提供する方法を提供しません。

Windows メディアプレーヤーと同期できるデバイスのサービスプロバイダーがこのインターフェイスをサポートしている場合、Windows Media デバイスマネージャーは Insert/2/3 操作中にこのメソッドを呼び出します。

WMDM_FILE_ATTR_FOLDER属性とWMDM_FILE_ATTR_FILE属性の両方が設定されている場合、フォルダー属性によってファイル属性がオーバーライドされ、新しいストレージがフォルダーとして作成されます。

クライアントで指定できるのは、WMDM_STORAGECONTROL_INSERTBEFORE、WMDM_STORAGECONTROL_INSERTAFTER、WMDM_STORAGECONTROL_INSERTINTOのいずれか 1 つだけです。

新しいストレージは、同じレベルで作成することも、現在のストレージがフォルダーである場合は現在のストレージに挿入することもできます。これは dwAttributes パラメーターの値によって制御されます。 WMDM_STORAGECONTROL_INSERTBEFOREまたはWMDM_STORAGECONTROL_INSERTAFTERを指定した場合、新しいストレージは現在のストレージと同じレベルで作成されます。 WMDM_STORAGECONTROL_INSERTINTOを指定すると、新しいストレージが現在のストレージに挿入されます。

WMDM_STORAGECONTROL_INSERTBEFOREとWMDM_STORAGECONTROL_INSERAFTERは、ファイルシステム内のコンテンツの順序を意味します。ファイルシステムが順序付けをサポートしていない場合 (FAT32 ファイルシステムなど)、両方のフラグは、現在のストレージのレベルで新しいストレージを挿入する効果が同じです。現在のストレージがストレージメディアのルートを表し、これら 2 つのフラグのいずれかが指定されている場合、操作は失敗します。

WMDM_STORAGECONTROL_INSERTINTOは、現在のストレージがフォルダーである場合にのみ有効です。現在のストレージがファイルであり、このフラグが指定されている場合、操作は失敗します。