ホーム › Media.WindowsMediaFormat › IWMStreamPrioritization

IWMStreamPrioritization

COM

IID8c1c6090-f9a8-4748-8ec3-dd1108ba1e77継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IWMStreamPrioritization インターフェイスは、ファイルの優先度レコードを設定および読み取るためのメソッドを提供します。ストリームの優先順位付けにより、コンテンツ作成者は ASF ファイル内のストリームの優先度を指定できます。

メソッド 2

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

vtbl 3 HRESULT GetPriorityRecords(WM_STREAM_PRIORITY_RECORD* pRecordArray, WORD* pcRecords)

GetPriorityRecords メソッドは、ストリームの一覧とその優先度をプロファイルから取得します。

pRecordArray	WM_STREAM_PRIORITY_RECORD*	out	WM_STREAM_PRIORITY_RECORD 構造体の配列へのポインター。この配列は現在のストリーム優先度データを受け取ります。
pcRecords	WORD*	inout	レコード数を受け取る WORD へのポインター。

戻り値

このメソッドは HRESULT を返します。指定できる値には次の表の値が含まれますが、これらに限定されません。

戻り値のコード	説明
S_OK	メソッドが成功しました。
E_INVALIDARG	pcRecords が NULL です。
ASF_E_BUFFERTOOSMALL	pcRecords が、ストリーム優先順位付けオブジェクトに存在するレコード数より少ない数を指定しています。

解説(Remarks)

GetPriorityRecords は 2 回呼び出す必要があります。1 回目の呼び出しでは、pRecordArray に NULL を渡します。戻り時に、pcRecords の値がストリーム優先度オブジェクト内の優先順位付けレコードの数に設定されます。その後、配列に必要な量のメモリを割り当て、2 回目の呼び出しでそのポインターを pRecordArray として渡すことができます。

データを格納するのに十分な要素が割り当てられていない配列を pRecordArray として渡すと、エラーコード ASF_E_BUFFERTOOSMALL が返されます。このエラーコードを返す場合でも、メソッドは pcRecords の値を設定します。

ストリーム優先順位付けオブジェクト内のレコードは、優先度の高い順に並べられます。

vtbl 4 HRESULT SetPriorityRecords(WM_STREAM_PRIORITY_RECORD* pRecordArray, WORD cRecords)

SetPriorityRecords メソッドは、配列のメンバーをストリーム優先順位付けオブジェクト内のストリーム優先度一覧として割り当てます。

pRecordArray	WM_STREAM_PRIORITY_RECORD*	in	WM_STREAM_PRIORITY_RECORD 構造体の配列へのポインター。
cRecords	WORD	in	レコード数。

戻り値

このメソッドは HRESULT を返します。指定できる値には次の表の値が含まれますが、これらに限定されません。

戻り値のコード

説明

S_OK

メソッドが成功しました。

E_INVALIDARG

cRecords が 0 より大きいレコード数を指定していますが、pRecordArray が NULL です。

または

配列規則のいずれかが破られています(「解説」セクションを参照)。

E_OUTOFMEMORY

ストリーム優先順位付けオブジェクトに配列を格納するのに必要なメモリを割り当てられません。

解説(Remarks)

有効な配列には重複するストリーム番号が含まれません。ストリームは優先度の降順で配列に並べられます。必須(mandatory)として指定されたストリームは、任意(optional)のエントリよりも前に配列内に出現する必要があります。これらの規則のいずれかが破られると、SetPriorityRecords は E_INVALIDARG を返します。

SetPriorityRecords は、既存のストリーム優先度配列があればそれを上書きします。cRecords に 0 を渡すことで配列をクリアできます。

このメソッドは、指定されたストリームがプロファイルに対して有効かどうかを検証しません。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IWMStreamPrioritization "{8C1C6090-F9A8-4748-8EC3-DD1108BA1E77}"
#usecom global IWMStreamPrioritization IID_IWMStreamPrioritization "{}"
#comfunc global IWMStreamPrioritization_GetPriorityRecords  3 var,var
#comfunc global IWMStreamPrioritization_SetPriorityRecords  4 var,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IWMStreamPrioritization "{8C1C6090-F9A8-4748-8EC3-DD1108BA1E77}"
#usecom global IWMStreamPrioritization IID_IWMStreamPrioritization "{}"
#comfunc global IWMStreamPrioritization_GetPriorityRecords  3 sptr,sptr
#comfunc global IWMStreamPrioritization_SetPriorityRecords  4 sptr,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。