IDDrawExclModeVideo
COM公式ドキュメント
IDDrawExclModeVideo インターフェイスは、DirectDraw 排他フルスクリーンモードでのビデオ再生を可能にします。
メソッド 7
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
SetDDrawObject メソッドは、以降の描画で使用する DirectDraw オブジェクトを設定します。
| pDDrawObject | IDirectDraw* | in | 使用するオブジェクトの IDirectDraw インターフェイスへのポインター。 |
戻り値
HRESULT 値を返します。想定される値には次のものがあります。
| 戻り値コード | 説明 |
|---|---|
| 成功。 | |
| 引数が無効です。 | |
|
指定したサーフェスを Overlay Mixer に設定しようとした際に DirectDraw エラーが発生しました。 |
解説(Remarks)
ゲームアプリケーションは、このメソッドを使用して自身の DirectDraw オブジェクトを Overlay Mixer フィルターと共有できます。これにより、IDDrawExclModeVideo::SetDDrawSurface で設定した指定のサーフェスにビデオを描画できます。
GetDDrawObject メソッドは、Overlay Mixer フィルターが使用している DirectDraw オブジェクトを取得します。
| ppDDrawObject | IDirectDraw** | out | Overlay Mixer が使用している IDirectDraw インターフェイスへのポインターのアドレス。 |
| pbUsingExternal | BOOL* | out | ブール値を受け取る変数へのポインター。Overlay Mixer が IDDrawExclModeVideo::SetDDrawObject で指定された DirectDraw オブジェクトを使用している場合は TRUE、そうでない場合は FALSE を受け取ります。 |
戻り値
HRESULT 値を返します。想定される値には次のものがあります。
| 戻り値コード | 説明 |
|---|---|
| 成功。 | |
| 引数が無効です。 | |
|
指定したサーフェスを Overlay Mixer に設定しようとした際に DirectDraw エラーが発生しました。 |
解説(Remarks)
フィルターグラフが DirectDraw オブジェクトを設定しておらず、かつ Overlay Mixer もまだオブジェクトを割り当てていない場合、pDDrawObject は NULL に、pbUsingExternal は FALSE に設定されます。
SetDDrawSurface メソッドは、以降の描画で使用する DirectDraw サーフェスを指定します。
| pDDrawSurface | IDirectDrawSurface* | in | 使用するサーフェスの IDirectDrawSurface インターフェイスへのポインター。 |
戻り値
インターフェイスの実装に依存する HRESULT 値を返します。
現在の DirectShow 実装での戻り値には次のものがあります。
| 戻り値 | 説明 |
|---|---|
| 成功。 | |
| 引数が無効です。 | |
|
指定したサーフェスを Overlay Mixer に設定しようとした際に DirectDraw エラーが発生しました。 |
解説(Remarks)
ゲームアプリケーションは、これを使用して自身の DirectDraw サーフェスを Overlay Mixer フィルターと共有し、指定したサーフェスにビデオを描画できます。このサーフェスは、IDDrawExclModeVideo::SetDDrawObject で指定したオブジェクトに関連付けられている必要があります。
GetDDrawSurface メソッドは、Overlay Mixer が使用している DirectDraw サーフェスを取得します。
| ppDDrawSurface | IDirectDrawSurface** | out | Overlay Mixer が使用している IDirectDrawSurface インターフェイスへのポインターのアドレス。 |
| pbUsingExternal | BOOL* | out | ブール値を受け取る変数へのポインター。Overlay Mixer が IDDrawExclModeVideo::SetDDrawSurface で指定された DirectDraw サーフェスを使用している場合は TRUE、そうでない場合は FALSE を受け取ります。 |
戻り値
HRESULT 値を返します。想定される値には次のものがあります。
| 戻り値コード | 説明 |
|---|---|
| 成功。 | |
| 引数が無効です。 | |
|
指定したサーフェスを Overlay Mixer に設定しようとした際に DirectDraw エラーが発生しました。 |
解説(Remarks)
フィルターグラフが DirectDraw サーフェスを設定しておらず、かつ Overlay Mixer もまだサーフェスを割り当てていない場合、pDDrawSurface は NULL に、pdUsingExternal は FALSE に設定されます。
SetDrawParameters メソッドは、元のビデオのどの部分を画面のどの位置に表示するかを指定します。
| prcSource | RECT* | in | 元のビデオの RECT 構造体へのポインター。 |
| prcTarget | RECT* | in | ビデオを画面上のどこに表示するかを示す RECT へのポインター。 |
戻り値
インターフェイスの実装に依存する HRESULT 値を返します。
GetNativeVideoProps メソッドは、Overlay Mixer のプライマリストリームの現在のビデオサイズとピクチャアスペクト比を取得します。
| pdwVideoWidth | DWORD* | out | ビデオの幅を受け取る変数のアドレス。 |
| pdwVideoHeight | DWORD* | out | ビデオの高さを受け取る変数のアドレス。 |
| pdwPictAspectRatioX | DWORD* | out | x 軸方向のアスペクト比を受け取る変数のアドレス。 |
| pdwPictAspectRatioY | DWORD* | out | y 軸方向のアスペクト比を受け取る変数のアドレス。 |
戻り値
HRESULT 値を返します。想定される値には次のものがあります。
| 戻り値コード | 説明 |
|---|---|
| 成功。 | |
| 引数が無効です。 |
解説(Remarks)
フィルターグラフは EC_VIDEO_SIZE_CHANGED イベントを監視し、受信時にこのメソッドを呼び出してアスペクト比と位置を調整する必要があります。
SetCallbackInterface メソッドは、Overlay Mixer のコールバックインターフェイスへのポインターを取得し、呼び出し元アプリケーションがビデオ再生中の表示調整について通知を受け取れるようにします。
| pCallback | IDDrawExclModeVideoCallback* | in | IDDrawExclModeVideoCallback インターフェイスを実装するオブジェクトへのポインター。pCallback が NULL の場合、コールバックインターフェイスは NULL に設定され、以降コールバックは行われません。以前のコールバックインターフェイスが存在した場合、それは解放され、以降そのインターフェイスへのコールバックは行われません。pCallback が NULL でなく、このメソッドが S_OK を返す場合、pCallback が指すオブジェクトの参照カウントがインクリメントされます。 |
| dwFlags | DWORD | in | ゼロでなければなりません。 |
戻り値
HRESULT 値を返します。想定される値には次のものがあります。
| 戻り値コード | 説明 |
|---|---|
| 成功。 | |
| 引数が無効です。 |
解説(Remarks)
アプリケーションは、オーバーレイのサイズ、位置、またはカラーキーの変更が発生したことについて通知を受け取るためにこのメソッドを使用します。これにより、ビデオの表示・非表示を切り替えたり、再生の開始時・終了時・再生中にビデオを調整したりできます。このメソッドを呼び出すことで、アプリケーションは IDDrawExclModeVideoCallback インターフェイスにアクセスし、そのインターフェイスへのポインターを Overlay Mixer に渡すことができます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IDDrawExclModeVideo "{153ACC21-D83B-11D1-82BF-00A0C9696C8F}" #usecom global IDDrawExclModeVideo IID_IDDrawExclModeVideo "{}" #comfunc global IDDrawExclModeVideo_SetDDrawObject 3 sptr #comfunc global IDDrawExclModeVideo_GetDDrawObject 4 sptr,var #comfunc global IDDrawExclModeVideo_SetDDrawSurface 5 sptr #comfunc global IDDrawExclModeVideo_GetDDrawSurface 6 sptr,var #comfunc global IDDrawExclModeVideo_SetDrawParameters 7 var,var #comfunc global IDDrawExclModeVideo_GetNativeVideoProps 8 var,var,var,var #comfunc global IDDrawExclModeVideo_SetCallbackInterface 9 sptr,int ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IDDrawExclModeVideo "{153ACC21-D83B-11D1-82BF-00A0C9696C8F}" #usecom global IDDrawExclModeVideo IID_IDDrawExclModeVideo "{}" #comfunc global IDDrawExclModeVideo_SetDDrawObject 3 sptr #comfunc global IDDrawExclModeVideo_GetDDrawObject 4 sptr,sptr #comfunc global IDDrawExclModeVideo_SetDDrawSurface 5 sptr #comfunc global IDDrawExclModeVideo_GetDDrawSurface 6 sptr,sptr #comfunc global IDDrawExclModeVideo_SetDrawParameters 7 sptr,sptr #comfunc global IDDrawExclModeVideo_GetNativeVideoProps 8 sptr,sptr,sptr,sptr #comfunc global IDDrawExclModeVideo_SetCallbackInterface 9 sptr,int ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。