Win32 API 日本語リファレンス
ホーム › Media.WindowsMediaFormat › IWMBackupRestoreProps

IWMBackupRestoreProps

COM
📘 Microsoft Learn (日本語) · English
IID3c8e0da6-996f-4ff3-a1af-4838f9377e2e継承元IUnknown自前メソッド開始 vtbl3

メソッド 6

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

vtbl 3 HRESULT GetPropCount(WORD* pcProps)
pcPropsWORD*out保持されているプロパティの総数を受け取る出力先である。
vtbl 4 HRESULT GetPropByIndex(WORD wIndex, LPWSTR pwszName, WORD* pcchNameLen, WMT_ATTR_DATATYPE* pType, BYTE* pValue, WORD* pcbLength)
wIndexWORDin取得するプロパティの0始まりのインデックスである。
pwszNameLPWSTRoutプロパティ名を受け取る文字列バッファである。NULLでサイズ問い合わせ可能である。
pcchNameLenWORD*inout名前バッファ文字数を入力し必要文字数を受け取る入出力ポインタである。
pTypeWMT_ATTR_DATATYPE*out値のデータ型を受け取るWMT_ATTR_DATATYPE出力先である。
pValueBYTE*outプロパティ値を受け取るバッファである。NULLでサイズ問い合わせ可能である。
pcbLengthWORD*inout値バッファサイズを入力し実際のバイト数を受け取る入出力ポインタである。
vtbl 5 HRESULT GetPropByName(LPWSTR pszName, WMT_ATTR_DATATYPE* pType, BYTE* pValue, WORD* pcbLength)
pszNameLPWSTRin取得するプロパティの名前を示すワイド文字列である。
pTypeWMT_ATTR_DATATYPE*out値のデータ型を受け取るWMT_ATTR_DATATYPE出力先である。
pValueBYTE*outプロパティ値を受け取るバッファである。NULLでサイズ問い合わせ可能である。
pcbLengthWORD*inout値バッファサイズを入力し実際のバイト数を受け取る入出力ポインタである。
vtbl 6 HRESULT SetProp(LPWSTR pszName, WMT_ATTR_DATATYPE Type, BYTE* pValue, WORD cbLength)
pszNameLPWSTRin設定するプロパティの名前を示すワイド文字列である。
TypeWMT_ATTR_DATATYPEin値のデータ型を示すWMT_ATTR_DATATYPE列挙値である。
pValueBYTE*in設定する値を保持するバッファへのポインタである。
cbLengthWORDin値バッファのバイト長である。
vtbl 7 HRESULT RemoveProp(LPWSTR pcwszName)
pcwszNameLPWSTRin削除するプロパティの名前を示すワイド文字列である。
vtbl 8 HRESULT RemoveAllProps()

HSP用 COM定義

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

出力引数: 
#define global IID_IWMBackupRestoreProps "{3C8E0DA6-996F-4FF3-A1AF-4838F9377E2E}"
#usecom global IWMBackupRestoreProps IID_IWMBackupRestoreProps "{}"
#comfunc global IWMBackupRestoreProps_GetPropCount    3 var
#comfunc global IWMBackupRestoreProps_GetPropByIndex  4 int,var,var,var,var,var
#comfunc global IWMBackupRestoreProps_GetPropByName   5 wstr,var,var,var
#comfunc global IWMBackupRestoreProps_SetProp         6 wstr,int,var,int
#comfunc global IWMBackupRestoreProps_RemoveProp      7 wstr
#comfunc global IWMBackupRestoreProps_RemoveAllProps  8
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。