IMediaPosition
COMIDispatch (デュアル)comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。公式ドキュメント
IMediaPosition インターフェイスには、ストリーム内の位置へシークするためのメソッドが含まれます。
メソッド 11
vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。
get_Duration メソッドは、ストリームの総再生時間を取得します。
| plength | DOUBLE* | out | ストリームの総長 (秒単位) を受け取る変数へのポインター。 |
戻り値
HRESULT 値を返します。とり得る値には次のものがあります。
| Return code | Description |
|---|---|
| 成功しました。 | |
| 実装されていません。 | |
| NULL ポインター引数です。 |
解説(Remarks)
このメソッドは、通常の再生速度でのストリームの総再生時間を取得します。再生速度を変更しても総再生時間には影響しません。
put_CurrentPosition メソッドは、ストリームの総再生時間を基準として現在位置を設定します。
| llTime | DOUBLE | in | 新しい位置 (秒単位)。 |
戻り値
HRESULT 値を返します。とり得る値には次のものがあります。
| Return code | Description |
|---|---|
| グラフが一時停止され、実行状態への遷移中です。 | |
| 成功しました。 | |
| 引数が無効です。 | |
| 実装されていません。 |
解説(Remarks)
llTime パラメーターで指定する位置は、再生速度を無視して総再生時間を基準とします。たとえば、ソースファイルの長さが 10 秒の場合、位置を 5.0 に設定すると、再生速度に関係なくグラフはファイルの中間へシークします。
フィルターグラフが実行中の場合、Filter Graph Manager はグラフを一時停止してシークコマンドを発行し、その後グラフを再び実行します。グラフが実行状態へ遷移している途中でメソッドが戻った場合、戻り値は S_FALSE になります。
フィルターがシークコマンドを受け取ったときに一時停止している場合、新しい位置のデータを取り込む前に既存のデータをフラッシュする必要があります。IPin::BeginFlush および IPin::EndFlush を参照してください。
get_CurrentPosition メソッドは、ストリームの総再生時間を基準として現在位置を取得します。
| pllTime | DOUBLE* | out | 現在位置 (秒単位) を受け取る変数へのポインター。 |
戻り値
HRESULT 値を返します。とり得る値には次のものがあります。
| Return code | Description |
|---|---|
| 成功しました。 | |
| 実装されていません。 | |
| NULL ポインター引数です。 |
解説(Remarks)
このメソッドは、再生が到達した現在位置を返します。この値には、再生速度と開始時刻に応じた調整が含まれます。たとえば、開始時刻が 5 秒、再生速度が 2.0 で、グラフを 4 秒間実行した場合、現在位置は 5 + (4 x 2.0) = 13.0 秒になります。
グラフが一時停止または停止している場合、現在位置は再生が再開される地点になります。
get_StopTime メソッドは、ストリームの総再生時間を基準として再生が停止する時刻を取得します。
| pllTime | DOUBLE* | out | 停止時刻 (秒単位) を受け取る変数へのポインター。 |
戻り値
HRESULT 値を返します。とり得る値には次のものがあります。
| Return code | Description |
|---|---|
| 成功しました。 | |
| 実装されていません。 | |
| NULL ポインター引数です。 |
解説(Remarks)
再生速度は、このメソッドが返す値には影響しません。
put_StopTime メソッドは、ストリームの総再生時間を基準として再生が停止する時刻を設定します。
| llTime | DOUBLE | in | 停止時刻 (秒単位)。 |
戻り値
HRESULT 値を返します。とり得る値には次のものがあります。
| Return code | Description |
|---|---|
| 成功しました。 | |
| 引数が無効です。 | |
| 実装されていません。 |
解説(Remarks)
停止時刻は、開始時刻と再生速度を無視します。たとえば、開始時刻が 2 秒、停止時刻が 12 秒、再生速度が 2.0 の場合、再生は 5 秒後 (実時間) に停止します。
get_PrerollTime メソッドは、開始位置より前にキューへ入れられるデータ量を取得します。
| pllTime | DOUBLE* | out | プリロール時間 (秒単位) を受け取る変数へのポインター。 |
戻り値
HRESULT 値を返します。とり得る値には次のものがあります。
| Return code | Description |
|---|---|
| 成功しました。 | |
| 実装されていません。 | |
| NULL ポインター引数です。 |
解説(Remarks)
プリロール とは、テーププレーヤーなどの非ランダムアクセスデバイスが動作を開始すべき、開始位置より前の時間です。
グラフ内のどのフィルターもこのメソッドを実装していない場合、Filter Graph Manager は *pllTime の値を 0 に設定し、S_OK を返します。
put_PrerollTime メソッドは、開始位置より前にキューへ入れられるデータ量を設定します。
| llTime | DOUBLE | in | プリロール時間 (秒単位)。 |
戻り値
解説(Remarks)
プリロール とは、テーププレーヤーなどの非ランダムアクセスデバイスが動作を開始すべき、開始位置より前の時間です。
put_Rate メソッドは、再生速度を設定します。
| dRate | DOUBLE | in | 再生速度。0 であってはなりません。 |
戻り値
HRESULT 値を返します。とり得る値には次のものがあります。
| Return code | Description |
|---|---|
| 成功しました。 | |
| 引数が無効です。 | |
| 実装されていません。 |
解説(Remarks)
再生速度は、通常速度に対する比率として表されます。したがって、1.0 は通常の再生速度、0.5 は半分の速度、2.0 は 2 倍の速度です。オーディオストリームでは、速度を変更するとピッチも変化します。
詳細については、IMediaSeeking::SetRate の解説を参照してください。
get_Rate メソッドは、再生速度を取得します。
| pdRate | DOUBLE* | out | 再生速度を受け取る変数へのポインター。 |
戻り値
HRESULT 値を返します。とり得る値には次のものがあります。
| Return code | Description |
|---|---|
| 成功しました。 | |
| 実装されていません。 | |
| NULL ポインター引数です。 |
解説(Remarks)
再生速度は、通常速度に対する比率として表されます。したがって、1.0 は通常の再生速度、0.5 は半分の速度、2.0 は 2 倍の速度です。
CanSeekForward メソッドは、フィルターグラフがストリーム内で前方へシークできるかどうかを判定します。
| pCanSeekForward | INT* | out | グラフが前方へシークできる場合は OATRUE、そうでない場合は OAFALSE を受け取る変数へのポインター。 |
戻り値
HRESULT 値を返します。とり得る値には次のものがあります。
| Return code | Description |
|---|---|
| 成功しました。 | |
| 実装されていません。 | |
| NULL ポインター引数です。 |
CanSeekBackward メソッドは、フィルターグラフがストリーム内で後方へシークできるかどうかを判定します。
| pCanSeekBackward | INT* | out | グラフが後方へシークできる場合は OATRUE、そうでない場合は OAFALSE を受け取る変数へのポインター。 |
戻り値
HRESULT 値を返します。とり得る値には次のものがあります。
| Return code | Description |
|---|---|
| 成功しました。 | |
| 実装されていません。 | |
| NULL ポインター引数です。 |
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IMediaPosition "{56A868B2-0AD4-11CE-B03A-0020AF0BA770}" #usecom global IMediaPosition IID_IMediaPosition "{}" #comfunc global IMediaPosition_get_Duration 7 var #comfunc global IMediaPosition_put_CurrentPosition 8 double #comfunc global IMediaPosition_get_CurrentPosition 9 var #comfunc global IMediaPosition_get_StopTime 10 var #comfunc global IMediaPosition_put_StopTime 11 double #comfunc global IMediaPosition_get_PrerollTime 12 var #comfunc global IMediaPosition_put_PrerollTime 13 double #comfunc global IMediaPosition_put_Rate 14 double #comfunc global IMediaPosition_get_Rate 15 var #comfunc global IMediaPosition_CanSeekForward 16 var #comfunc global IMediaPosition_CanSeekBackward 17 var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IMediaPosition "{56A868B2-0AD4-11CE-B03A-0020AF0BA770}" #usecom global IMediaPosition IID_IMediaPosition "{}" #comfunc global IMediaPosition_get_Duration 7 sptr #comfunc global IMediaPosition_put_CurrentPosition 8 double #comfunc global IMediaPosition_get_CurrentPosition 9 sptr #comfunc global IMediaPosition_get_StopTime 10 sptr #comfunc global IMediaPosition_put_StopTime 11 double #comfunc global IMediaPosition_get_PrerollTime 12 sptr #comfunc global IMediaPosition_put_PrerollTime 13 double #comfunc global IMediaPosition_put_Rate 14 double #comfunc global IMediaPosition_get_Rate 15 sptr #comfunc global IMediaPosition_CanSeekForward 16 sptr #comfunc global IMediaPosition_CanSeekBackward 17 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。