IMFByteStreamBuffering
COM公式ドキュメント
バイトストリームがネットワークからデータをバッファリングする方法を制御します。
解説(Remarks)
バイトストリームがこのインターフェイスを実装している場合、メディアソースはこれを使用してバイトストリームのバッファリング方法を制御できます。このインターフェイスは、ネットワークからデータを読み取るバイトストリーム向けに設計されています。
このインターフェイスを実装するバイトストリームは、IMFMediaEventGenerator インターフェイスも実装する必要があります。バイトストリームはバッファリングを開始すると MEBufferingStarted イベントを送信します。バッファリングを停止すると MEBufferingStopped イベントを送信します。
バイトストリームは、MEBufferingStarted イベントごとに、対応する MEBufferingStopped イベントを送信する必要があります。メディアソースが EnableBuffering を値 TRUE で呼び出してバッファリングを有効にしていない限り、バイトストリームは MEBufferingStarted イベントを送信してはなりません。
バイトストリームは MEBufferingStarted イベントを送信した後、次のいずれかが発生した場合に MEBufferingStopped を送信する必要があります。
- バイトストリームがデータのバッファリングを完了した。
- バイトストリームがストリームの終端に達した。
- メディアソースが EnableBuffering を値 FALSE で呼び出した。
- メディアソースが StopBuffering を呼び出した。
バッファリングが無効な場合、バイトストリームはバッファリングイベントを一切送信しません。ただし内部的には、I/O 要求の完了を待つ間にデータをバッファリングすることがあります。そのため、IMFByteStream のメソッドが完了するまでに不定の時間がかかる場合があります。
バイトストリームが内部的にデータをバッファリングしている際にメディアソースが EnableBuffering を値 TRUE で呼び出した場合、バイトストリームは MEBufferingStarted をただちに送信できます。
プレゼンテーションの開始後、メディアソースは、開始中に受信した MEBufferingStarted および MEBufferingStopped イベントを転送する必要があります。Media Session はバッファリングの進行中はプレゼンテーションクロックを一時停止し、バッファリングが完了するとプレゼンテーションクロックを再開します。メディアソースは、プレゼンテーションの再生中のみこれらのイベントを転送する必要があります。これらのイベントを Media Session に送信する目的は、ソースがデータをバッファリングしている間、プレゼンテーション時間を一時停止することにあります。
メソッド 3
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
バッファリングパラメーターを設定します。
| pParams | MFBYTESTREAM_BUFFERING_PARAMS* | in | バッファリングパラメーターを格納した MFBYTESTREAM_BUFFERING_PARAMS 構造体へのポインター。バイトストリームはこの情報を使用して、ネットワークからバッファリングするデータ量を計算します。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれますが、これらに限定されません。
| 戻り値 | 説明 |
|---|---|
| メソッドが成功しました。 |
バッファリングを有効または無効にします。
| fEnable | BOOL | in | バイトストリームがデータをバッファリングするかどうかを指定します。TRUE の場合、バッファリングが有効になります。FALSE の場合、バッファリングが無効になります。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれますが、これらに限定されません。
| 戻り値 | 説明 |
|---|---|
| メソッドが成功しました。 |
解説(Remarks)
このメソッドを呼び出す前に、IMFByteStreamBuffering::SetBufferingParams を呼び出して、バイトストリームにバッファリングパラメーターを設定してください。
進行中のバッファリングを停止します。
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれますが、これらに限定されません。
| 戻り値 | 説明 |
|---|---|
| バイトストリームがバッファリングを正常に停止しました。 | |
| 進行中のバッファリングはありませんでした。 |
解説(Remarks)
バイトストリームが現在データをバッファリングしている場合、バッファリングを停止して MEBufferingStopped イベントを送信します。バイトストリームが現在バッファリングしていない場合、このメソッドは何も行いません。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IMFByteStreamBuffering "{6D66D782-1D4F-4DB7-8C63-CB8C77F1EF5E}" #usecom global IMFByteStreamBuffering IID_IMFByteStreamBuffering "{}" #comfunc global IMFByteStreamBuffering_SetBufferingParams 3 var #comfunc global IMFByteStreamBuffering_EnableBuffering 4 int #comfunc global IMFByteStreamBuffering_StopBuffering 5 ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IMFByteStreamBuffering "{6D66D782-1D4F-4DB7-8C63-CB8C77F1EF5E}" #usecom global IMFByteStreamBuffering IID_IMFByteStreamBuffering "{}" #comfunc global IMFByteStreamBuffering_SetBufferingParams 3 sptr #comfunc global IMFByteStreamBuffering_EnableBuffering 4 int #comfunc global IMFByteStreamBuffering_StopBuffering 5 ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。