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

IWMPacketSize2

COM
📘 Microsoft Learn (日本語) · English
IID8bfc2b9e-b646-4233-a877-1c6a079669dc継承元IWMPacketSize自前メソッド開始 vtbl5

公式ドキュメント

IWMPacketSize2 インターフェイスは、プロファイルの最小パケットサイズを設定および取得するためのメソッドを提供します。IWMPacketSize2 インターフェイスは、プロファイルオブジェクト、リーダーオブジェクト、または同期リーダーオブジェクトのいずれからも取得できます。

メソッド 2

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

vtbl 5 HRESULT GetMinPacketSize(DWORD* pdwMinPacketSize)

GetMinPacketSize メソッドは、プロファイルを使用して作成されるファイルの最小パケットサイズを取得します。リーダーオブジェクトまたは同期リーダーオブジェクトに属するインターフェイスからこのメソッドを使用した場合、取得される最小パケットサイズは常に 0 になります。

pdwMinPacketSizeDWORD*out最小パケットサイズを受け取る DWORD へのポインター。

戻り値

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

戻り値 説明
S_OK
 メソッドが成功しました。
E_INVALIDARG
 NULL ポインター引数です。
vtbl 6 HRESULT SetMinPacketSize(DWORD dwMinPacketSize)

SetMinPacketSize メソッドは、プロファイルを使用して作成されるファイルの最小パケットサイズを設定します。このメソッドは、リーダーオブジェクトまたは同期リーダーオブジェクトに属するインターフェイスから呼び出すことはできません。

dwMinPacketSizeDWORDinプロファイルを使用して作成されるファイルの新しい最小パケットサイズを指定する DWORD。

戻り値

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

解説(Remarks)

このメソッドは、ライターに既定のサイズよりも大きいパケットサイズを強制的に作成させるために使用します。ライターオブジェクトは、既定ではビットレートに基づいて最適なパケットサイズを選択します。350 kbps 未満のビットレートでは、約 1440 バイトになります。100 kbps 未満では、既定のパケットサイズは 1 秒あたり約 10 パケット、すなわち ((bit_rate / 8) / 10) となるように計算されます。

パケットが大きいほどファイルは小さくなりますが、ネットワーク経由でのストリーミングが難しくなる場合もあります。ストリーミング配信するファイルを作成する場合は、このメソッドの使用に注意してください。パケットサイズは、350 kbps を超える場合の既定のパケットサイズである 8000 バイトより大きい値には決して設定しないことをお勧めします。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IWMPacketSize2 "{8BFC2B9E-B646-4233-A877-1C6A079669DC}"
#usecom global IWMPacketSize2 IID_IWMPacketSize2 "{}"
#comfunc global IWMPacketSize2_GetMinPacketSize  5 var
#comfunc global IWMPacketSize2_SetMinPacketSize  6 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。