Platform SDK: DirectX

IDDVideoPortContainer::CreateVideoPort

IDDVideoPortContainer::CreateVideoPort メソッドは、DirectDrawVideoPort オブジェクトを作成する。

HRESULT CreateVideoPort(
  DWORD dwFlags,                               
  LPDDVIDEOPORTDESC lpDDVideoPortDesc,         
  LPDIRECTDRAWVIDEOPORT FAR *lplpDDVideoPort,  
  IUnknown FAR *pUnkOuter                      
);

パラメータ

dwFlags
ビデオポート コントロール オプションを指定するフラグ。このパラメータには、次のフラグの 1 つを指定する。もしくは、コントロール オプションを必要としない場合は NULL にする。
DDVPCREATE_VBIONLY
このプロセスは、単にビデオ ストリームの VBI 部分を制御する。
DDVPCREATE_VIDEOONLY
このプロセスは、単にビデオ ストリームの VBI でない (ビデオ) 部分を制御する。
lpDDVideoPortDesc
作成する DirectDrawVideoPort オブジェクトを記述する DDVIDEOPORTDESC 構造体のアドレス。
lplpDDVideoPort
呼び出しが成功した場合に、新しい DirectDrawVideoPort オブジェクトの IDirectDrawVideoPort インターフェイスへのポインタを格納する変数のアドレス。
pUnkOuter
COM 処理機能との将来的な互換のためにある。ただし、現時点では、このパラメータを NULL に設定しないと、このメソッドはエラーを返す。

戻り値

成功すれば、DD_OK を返す。

失敗すれば、以下のエラー値のいずれかを返す。

DDERR_CURRENTLYNOTAVAIL
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_NOCOOPERATIVELEVELSET
DDERR_OUTOFCAPS
DDERR_OUTOFMEMORY

動作環境

  Windows NT/2000 :Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dvp.h で宣言。
  インポート ライブラリ : ddraw.lib を使用。