ホーム › Media.WindowsMediaFormat › IWMBandwidthSharing

IWMBandwidthSharing

COM

📘 Microsoft Learn (日本語) · English

IIDad694af1-f8d9-42f8-bc47-70311b0c4f9e継承元IWMStreamList自前メソッド開始 vtbl6

公式ドキュメント

IWMBandwidthSharing インターフェースには、結合されたストリームのプロパティを管理するためのメソッドが含まれています。帯域幅を共有するストリームのリストは、帯域幅共有オブジェクトに格納されます。

メソッド 4

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

vtbl 6 HRESULT GetType(GUID* pguidType)

GetType メソッドは、帯域幅共有オブジェクトの共有の種類を取得します。

pguidType

GUID*

out

使用する結合ストリームの種類を指定するグローバル一意識別子へのポインター。これは次のいずれかの値になります。

帯域幅共有の種類	説明
CLSID_WMBandwidthSharing_Exclusive	構成ストリームのうち、任意の時点でアクティブにできるのは 1 つだけです。
CLSID_WMBandwidthSharing_Partial	構成ストリームは同時にアクティブにできます。

戻り値

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

戻り値	説明
S_OK	メソッドは成功しました。
E_INVALIDARG	渡されたポインターが NULL です。

解説(Remarks)

帯域幅共有オブジェクトの設定は、純粋に情報提供を目的としたものです。正確性はチェックされません。

vtbl 7 HRESULT SetType(GUID* guidType)

SetType メソッドは、帯域幅共有オブジェクトの共有の種類 (排他または部分) を設定します。

guidType

GUID*

使用する結合ストリームの種類を指定するグローバル一意識別子。有効な GUID は次の表に示すもののみです。

帯域幅共有の種類	説明
CLSID_WMBandwidthSharing_Exclusive	構成ストリームのうち、任意の時点でアクティブにできるのは 1 つだけです。
CLSID_WMBandwidthSharing_Partial	構成ストリームは同時にアクティブにできます。

戻り値

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

戻り値	説明
S_OK	メソッドは成功しました。
E_INVALIDARG	guidType に渡された GUID が CLSID_BandwidthSharingExclusive または CLSID_BandwidthSharingPartial 以外の値です。

解説(Remarks)

帯域幅共有オブジェクトの設定は、純粋に情報提供を目的としたものです。正確性はチェックされません。

vtbl 8 HRESULT GetBandwidth(DWORD* pdwBitrate, DWORD* pmsBufferWindow)

GetBandwidth メソッドは、結合ストリームの帯域幅と最大バッファーサイズを取得します。

pdwBitrate	DWORD*	out	ビットレート (ビット/秒) を格納する DWORD へのポインター。ストリームの合計帯域幅はこの値を超えることはできません。
pmsBufferWindow	DWORD*	out	バッファーウィンドウ (ミリ秒) を格納する DWORD へのポインター。ストリームの合計バッファーサイズはこの値を超えることはできません。

戻り値

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

戻り値	説明
S_OK	メソッドは成功しました。
E_INVALIDARG	パラメーターの一方または両方が NULL です。

解説(Remarks)

帯域幅共有オブジェクトの設定は、純粋に情報提供を目的としたものです。正確性はチェックされません。

vtbl 9 HRESULT SetBandwidth(DWORD dwBitrate, DWORD msBufferWindow)

SetBandwidth メソッドは、結合ストリームの帯域幅と最大バッファーサイズを設定します。

dwBitrate	DWORD	in	ビットレート (ビット/秒) を格納する DWORD。ストリームの合計帯域幅はこの値を超えることはできません。
msBufferWindow	DWORD	in	バッファーウィンドウ (ミリ秒) を指定します。ストリームの合計バッファーサイズはこの値を超えることはできません。

戻り値

このメソッドは常に S_OK を返します。

解説(Remarks)

帯域幅共有オブジェクトの設定は、純粋に情報提供を目的としたものです。正確性はチェックされません。

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