Platform SDK: DirectX

IDirectDrawVideoPort::GetInputFormats

IDirectDrawVideoPort::GetInputFormats メソッドは、DirectDrawVideoPort オブジェクトがサポートする入力フォーマットを取得する。

HRESULT GetInputFormats(
  LPDWORD lpNumFormats,       
  LPDDPIXELFORMAT lpFormats,  
  DWORD dwFlags               
);

パラメータ

lpNumFormats
lpFormats の配列で保持できるエントリ数を含む変数のアドレス。この数が全コード数より少ない場合、メソッドは適合するすべてのコードを配列に格納し、全コード数を示すように lpNumFormats の値を設定して、DDERR_MOREDATA を返す。
lpFormats
この DirectDrawVideoPort オブジェクトによってサポートされる入力情報を格納する DDPIXELFORMAT 構造体の配列のアドレス。このパラメータが NULL の場合、メソッドは lpNumFormats をサポートされるフォーマット数に設定して、DD_OK を返す。
dwFlags
ビデオ信号のどの部分に対してフォーマットを列挙するかを指定するフラグ。以下のフラグのうち、いずれかの値を取る。
DDVPFORMAT_VIDEO
ビデオ データのフォーマットを返す。
DDVPFORMAT_VBI
VBI データのフラグを返す。

戻り値

成功すれば、DD_OK を返す。

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

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_MOREDATA

注意

このメソッドは、サポートされるフォーマット数を返すために使用することもできる。この場合は、lpFormats パラメータを NULL に設定する。メソッドが返ると、lpNumFormats の変数にはサポートされる入力フォーマットの合計数が含まれる。

動作環境

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