Platform SDK: DirectX

IDirectDrawVideoPort::GetBandwidthInfo

IDirectDrawVideoPort::GetBandwidthInfo メソッドは、要求される最小オーバーレイ ズーム係数と、提供される出力ピクセル フォーマットを使うビデオ ポートのデバイス制限を取得する。

HRESULT GetBandwidthInfo( 
  LPDDPIXELFORMAT lpddpfFormat,       
  DWORD dwWidth,                      
  DWORD dwHeight,                     
  DWORD dwFlags,                      
  LPDDVIDEOPORTBANDWIDTH lpBandwidth  
);

パラメータ

lpddpfFormat
帯域幅情報を取得するための出力ピクセル フォーマットを記述する DDPIXELFORMAT 構造体のアドレス。
dwWidthdwHeight
オーバーレイまたはビデオ データのディメンジョン。これらのパラメータは、dwFlags パラメータで指定する値に依存する。
dwFlags
どのようにメソッドが dwWidth および dwHeight パラメータを判断するかを示すフラグ。以下のフラグのうち、いずれかの値を取る。
DDVPB_OVERLAY
dwWidth および dwHeight パラメータは、転送元オーバーレイ サーフェスのサイズを示す。ビデオ ポートがオーバーレイ転送元サイズに依存する場合、このフラグを使用する。
DDVPB_TYPE
dwWidth および dwHeight パラメータは、設定されない。メソッドは、関連付けられた DDVIDEOPORTBANDWIDTH 構造体の dwCaps メンバでデバイスの依存タイプを取得する。最初にこのメソッドを呼び出す場合、このフラグを使用する。
DDVPB_VIDEOPORT
dwWidth および dwHeight パラメータは、ビデオ ポートがフレーム バッファに書き込むビデオ データのプレスケール サイズを示す。ビデオ ポートがオーバーレイ ズーム係数に依存する場合、このフラグを使用する。
lpBandwidth
取得された帯域幅およびデバイス情報を格納する DDVIDEOPORTBANDWIDTH 構造体のアドレス。

戻り値

成功すれば、DD_OK を返す。

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

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS

注意

このメソッドは通常 2 回呼び出される。最初に呼び出す場合、dwFlags パラメータに DDVPB_TYPE フラグを指定して、デバイスのオーバーレイ依存タイプについての情報を取得する。DDVPB_VIDEOPORT または DDVPB_OVERLAY フラグを使った連続する呼び出しは、デバイスの依存タイプを考慮して判断されなくてはならない。

動作環境

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