ホーム › Media.DeviceManager › IMDSPStorage2

IMDSPStorage2

COM

📘 Microsoft Learn (日本語) · English

IID0a5e07a5-6454-4451-9c36-1c6ae7e2b1d6継承元IMDSPStorage自前メソッド開始 vtbl13

公式ドキュメント

IMDSPStorage2 インターフェイスは、拡張属性を取得および設定するメソッドを提供し、記憶メディアの名前からそのポインターを取得できるようにすることで、IMDSPStorage を拡張します。

メソッド 4

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 13 HRESULT GetStorage(LPWSTR pszStorageName, IMDSPStorage** ppStorage)

GetStorage メソッドは、すべてのストレージを列挙して目的のものを探す代わりに、ストレージ名から直接ストレージオブジェクトにアクセスできるようにします。

pszStorageName	LPWSTR	in	ストレージ名を格納する null 終端文字列へのポインター。
ppStorage	IMDSPStorage**	out	pszStorageName で指定されたストレージオブジェクトへのポインター。該当するストレージが見つからない場合は NULL になります。

戻り値

このメソッドは HRESULT を返します。Windows Media Device Manager のすべてのインターフェイスメソッドは、次の種類のエラーコードを返す可能性があります。

標準の COM エラーコード
HRESULT 値に変換された Windows エラーコード
Windows Media Device Manager のエラーコード

返される可能性のあるエラーコードの詳細な一覧については、Error Codes を参照してください。

解説(Remarks)

IMDSPStorage2::GetStorage インターフェイスは、IMDSPStorage の機能を拡張します。

IMDSPStorage2::GetStorage はワイルドカード文字をサポートしません。また再帰的ではないため、現在のストレージ内にあるストレージオブジェクトのみを検索します。

このメソッドを実装しない場合は、E_NOTIMPL を返す必要があります (WMDM_E_NOT_SUPPORTED や、未実装であることを示すその他のコードを返してはいけません)。これにより、Windows Media Device Manager は、pszStorageName に渡されたストレージ名と一致するものをすべてのストレージを列挙して探すことで、この機能を自ら代替しようとします。

名前に基づいてストレージオブジェクトを効率的に返せるよう、サービスプロバイダーがこのメソッドを実装することを強く推奨します。

このメソッドは省略可能です。詳細については、Mandatory and Optional Interfaces を参照してください。

vtbl 14 HRESULT CreateStorage2(DWORD dwAttributes, DWORD dwAttributesEx, WAVEFORMATEX* pAudioFormat, VIDEOINFOHEADER* pVideoFormat, LPWSTR pwszName, ULONGLONG qwFileSize, IMDSPStorage** ppNewStorage)

CreateStorage2 メソッドは、指定された名前で新しいストレージを作成し、新しく作成されたストレージ上の IMDSPStorage インターフェイスへのポインターを返します。

dwAttributes	DWORD	in	IMDSPStorage::CreateStorage メソッドで説明されている属性を格納する DWORD。
dwAttributesEx	DWORD	in	拡張属性を格納する DWORD。現在、定義されている拡張属性はありません。
pAudioFormat	WAVEFORMATEX*	inoptional	オブジェクトのオーディオ形式情報を格納する _WAVEFORMATEX 構造体へのポインター。このパラメーターは省略可能で、ファイルがオーディオでない場合は無視されます。
pVideoFormat	VIDEOINFOHEADER*	inoptional	オブジェクトのビデオ形式情報を格納する _VIDEOINFOHEADER 構造体へのポインター。このパラメーターは省略可能で、ファイルがビデオでない場合は無視されます。
pwszName	LPWSTR	in	新しいストレージの名前を格納するワイド文字の null 終端文字列へのポインター。
qwFileSize	ULONGLONG	in	作成するファイルのサイズを格納する QWORD。作成時点で出力ファイルの合計サイズが不明な場合、この値は 0 に設定されます。
ppNewStorage	IMDSPStorage**	out	新しく作成されたストレージの IMDSPStorage インターフェイスを受け取る IMDSPStorage ポインターへのポインター。

戻り値

標準の COM エラーコード
HRESULT 値に変換された Windows エラーコード
Windows Media Device Manager のエラーコード

返される可能性のあるエラーコードの詳細な一覧については、Error Codes を参照してください。

解説(Remarks)

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 は、現在のストレージがフォルダーである場合にのみ有効です。現在のストレージがファイルであるときにこのフラグを指定すると、操作は失敗します。

このメソッドは実装する必要があります。WMDM_E_NOTSUPPORTED や E_NOTIMPL を返してはいけません。詳細については、Mandatory and Optional Interfaces を参照してください。

vtbl 15 HRESULT SetAttributes2(DWORD dwAttributes, DWORD dwAttributesEx, WAVEFORMATEX* pAudioFormat, VIDEOINFOHEADER* pVideoFormat)

SetAttributes2 メソッドは、ストレージオブジェクトのオーディオ形式やビデオ形式および拡張属性を設定できるようにすることで、IMDSPStorage::SetAttributes を拡張します。

dwAttributes	DWORD	in	IWMDMStorage::SetAttributes メソッドで定義されている、設定する属性を格納する DWORD
dwAttributesEx	DWORD	in	拡張属性を格納する DWORD。現在、定義されている拡張属性はありません。
pAudioFormat	WAVEFORMATEX*	inoptional	オブジェクトのオーディオ形式情報を格納する _WAVEFORMATEX 構造体へのポインター。このパラメーターは省略可能で、ファイルがオーディオでない場合は無視されます。
pVideoFormat	VIDEOINFOHEADER*	inoptional	オブジェクトのビデオ形式情報を格納する _VIDEOINFOHEADER 構造体へのポインター。このパラメーターは省略可能で、ファイルがビデオでない場合は無視されます。

戻り値

標準の COM エラーコード
HRESULT 値に変換された Windows エラーコード
Windows Media Device Manager のエラーコード

返される可能性のあるエラーコードの詳細な一覧については、Error Codes を参照してください。

解説(Remarks)

IWMDMStorage::SetAttributes の解説を参照してください。

このメソッドは省略可能です。詳細については、Mandatory and Optional Interfaces を参照してください。

vtbl 16 HRESULT GetAttributes2(DWORD* pdwAttributes, DWORD* pdwAttributesEx, WAVEFORMATEX* pAudioFormat, VIDEOINFOHEADER* pVideoFormat)

GetAttributes2 メソッドは、ファイルまたはストレージの属性を取得します。

pdwAttributes	DWORD*	out	IWMDMStorage::GetAttributes メソッドで定義されている基本属性を格納する DWORD へのポインター。
pdwAttributesEx	DWORD*	out	拡張属性を格納する DWORD へのポインター。現在、定義されている拡張属性はありません。
pAudioFormat	WAVEFORMATEX*	inoutoptional	オブジェクトのオーディオ形式情報を格納する _WAVEFORMATEX 構造体へのポインター。このパラメーターは省略可能で、ファイルがオーディオでない場合は無視されます。
pVideoFormat	VIDEOINFOHEADER*	inoutoptional	オブジェクトのビデオ形式情報を格納する _VIDEOINFOHEADER 構造体へのポインター。このパラメーターは省略可能で、ファイルがビデオでない場合は無視されます。

戻り値

標準の COM エラーコード
HRESULT 値に変換された Windows エラーコード
Windows Media Device Manager のエラーコード

返される可能性のあるエラーコードの詳細な一覧については、Error Codes を参照してください。

解説(Remarks)

IWMDMStorage::GetAttributes の解説を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_IMDSPStorage2 "{0A5E07A5-6454-4451-9C36-1C6AE7E2B1D6}"
#usecom global IMDSPStorage2 IID_IMDSPStorage2 "{}"
#comfunc global IMDSPStorage2_GetStorage      13 wstr,sptr
#comfunc global IMDSPStorage2_CreateStorage2  14 int,int,var,var,wstr,int64,sptr
#comfunc global IMDSPStorage2_SetAttributes2  15 int,int,var,var
#comfunc global IMDSPStorage2_GetAttributes2  16 var,var,var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IMDSPStorage2 "{0A5E07A5-6454-4451-9C36-1C6AE7E2B1D6}"
#usecom global IMDSPStorage2 IID_IMDSPStorage2 "{}"
#comfunc global IMDSPStorage2_GetStorage      13 wstr,sptr
#comfunc global IMDSPStorage2_CreateStorage2  14 int,int,sptr,sptr,wstr,int64,sptr
#comfunc global IMDSPStorage2_SetAttributes2  15 int,int,sptr,sptr
#comfunc global IMDSPStorage2_GetAttributes2  16 sptr,sptr,sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。