Microsoft DirectX 8.0

ビデオ関数とイメージ関数

宣言 : Wxutil.h

Microsoft® DirectShow® 基底クラスの Wxutil.h ヘッダー ファイルは、VIDEOINFOHEADER 構造体と BITMAPINFO 構造体との間で変換を行うのに役立つ関数およびマクロを提供する。

BIT_MASKS_MATCH 2 つのビデオ イメージのマスクを比較する。
BITMASKS指定された VIDEOINFOHEADER 構造体のビットマスクの配列へのポインタを取得する。
COLORS指定された VIDEOINFOHEADER 構造体のカラー パレットを記述する RGBQUAD へのポインタを取得する。
ContainsPaletteビデオ イメージにカラー パレットが含まれているかどうかをチェックする。
ConvertVideoInfoToVideoInfo2VIDEOINFO ストリーム フォーマットを VIDEOINFOHEADER2 フォーマットに変換する。
DIBSIZE指定されたビットマップのバイト サイズを計算する。
GetBitCountピクセルあたりのビット数を調べる。
GetBitmapFormatSizeVIDEOINFOHEADER 構造体とその関連データを作成するのに必要なサイズ (バイト単位) を調べる。
GetBitmapPaletteVIDEOINFOHEADER 構造体の最初のパレット エントリを取得する。
GetBitmapSizeイメージを保持するのに必要なサイズ (バイト単位) を調べる。
GetBitmapSubtype任意のビットマップ情報ヘッダー構造体の GUID サブタイプを調べる。
GetSubtypeName任意の GUID サブタイプの (デバッグ) 名前を調べる。
GetTrueColorType任意のビットマップ ヘッダーの GUID サブタイプを調べる。
HEADER指定されたビデオ イメージからイメージ データへのポインタを取得する。
MPEG1_SEQUENCE_INFO指定された MPEG-1 ビデオ イメージのシーケンス ヘッダーを取得する。
PALETTISEDビデオ イメージのカラー パレットが 8 ビット以下であるかどうかをチェックする。
PALETTE_ENTRIESビデオ イメージのパレットの色数を返す。
RESET_MASKS指定されたビデオ イメージのビットマスクをクリアする。
RESET_HEADER指定されたビデオ イメージをクリアする。
RESET_PALETTE指定されたビデオ イメージのカラー パレットをクリアする。
SIZE_EGA_PALETTEEGA (4 ビット) カラー パレットのサイズを計算する。
SIZE_MASKSマスクのカラー パレットのサイズを計算する。
SIZE_MPEG1VIDEOINFO指定された MPEG-1 ビデオ イメージのサイズを計算する。
SIZE_PALETTE8 ビット カラー パレットのサイズを計算する。
SIZE_PREHEADERビデオ イメージのビットマップ情報のバイト オフセットを計算する。
SIZE_VIDEOHEADERビデオ イメージのサイズを計算する。
TRUECOLORINFO指定された VIDEOINFOHEADER 構造体のビットマスクおよびカラー パレットを記述する TRUECOLORINFO 構造体の配列へのポインタを取得する。

これらの関数は、ビデオ データ ストリームを記述するために DirectShow 全般で使用される VIDEOINFOHEADER 構造体の管理に役立つ。Microsoft® Win32® および既存のマルチメディアで使用される BITMAPINFO 構造体に似ているが、VIDEOINFOHEADER にはいくつかの新しいビデオ固有のフィールドが追加されている。

グローバル データ説明
bits555 RGB 555 ビットマップのカラー ビットマスクの配列
bits565 RGB 565 ビットマップのカラー ビットマスクの配列
bits888 RGB 24 ビット ビットマップのカラー ビットマスクの配列

BIT_MASKS_MATCH

ビデオ関数とイメージ関数

指定されたビデオ イメージのビットマスクを取得する。

構文

BIT_MASKS_MATCH(
  pbmi1,
  pbmi2
  )

パラメータ

pbmi1
最初のビデオ イメージを含む Win32 VIDEOINFOHEADER 構造体へのポインタ。
pbmi2
2 番目のビデオ イメージを含む Win32 VIDEOINFOHEADER 構造体へのポインタ。

戻り値

両方のビデオ イメージのビットマスクが同じ場合はゼロ以外の値を返し、それ以外の場合はゼロを返す。

BITMASKS

ビデオ関数とイメージ関数

指定されたビデオ イメージのビットマスクを取得する。

構文

BITMASKS(
  pbmi
  )

パラメータ

pbmi
ビデオ イメージを含む Win32 VIDEOINFOHEADER 構造体へのポインタ。

戻り値

指定された VIDEOINFOHEADER 構造体のビットマスクの配列へのポインタを返す。

COLORS

ビデオ関数とイメージ関数

指定されたビデオ イメージのカラー パレットを取得する。

構文

COLORS(
  pbmi
  )

パラメータ

pbmi
ビデオ イメージを含む Win32 VIDEOINFOHEADER 構造体へのポインタ。

戻り値

指定された VIDEOINFOHEADER 構造体のカラー パレットを記述する RGBQUAD 構造体の配列へのポインタを返す。

ContainsPalette

ビデオ関数とイメージ関数

ビデオ イメージにカラー パレットが含まれているかどうかをチェックする。

構文

BOOL ContainsPalette(
  const VIDEOINFOHEADER *pVideoInfo
  );

パラメータ

pVideoInfo
VIDEOINFOHEADER 構造体へのポインタ。

戻り値

VIDEOINFOHEADER 構造体がカラー パレットを含んでいる場合は TRUE を返し、それ以外の場合は FALSE を返す。

ConvertVideoInfoToVideoInfo2

ビデオ関数とイメージ関数

VIDEOINFO ストリーム フォーマットを VIDEOINFOHEADER2 フォーマットに変換する。

構文

STDAPI ConvertVideoInfoToVideoInfo2(
    AM_MEDIA_TYPE *pmt
    );

パラメータ

pmt
[in/out] AM_MEDIA_TYPE 列挙型へのポインタ。

戻り値

インターフェイスの実装に依存する HRESULT 値を返す。HRESULT には、次のいずれかの標準定数、または一覧にないほかの値が含まれる。

E_OUTOFMEMORY 処理でメモリ不足が発生した。
S_OK 成功。

注意

成功した場合、この関数は AM_MEDIA_TYPEformattype メンバを変更し、登録された GUID を VIDEOINFO 型から VIDEOINFOHEADER2 型に変更する。

DIBSIZE

ビデオ関数とイメージ関数

指定された (デバイスに依存しない) ビットマップのバイト サイズを計算する。

構文

DIBSIZE(
  bi
  )

パラメータ

bi
ソース ビットマップを指定する Win32 BITMAPINFOHEADER 構造体。

戻り値

bi パラメータのバイト サイズを返す。

GetBitCount

ビデオ関数とイメージ関数

ピクセルあたりのビット数を調べる。

構文

WORD GetBitCount(
  const GUID *pSubtype
  );

パラメータ

pSubtype
任意の ビデオ サブタイプの GUID へのポインタ。

戻り値

このサブタイプのピクセルあたりのビット数を返す。エラーが発生した場合は、USHRT_MAX を返す。

GetBitmapFormatSize

ビデオ関数とイメージ関数

VIDEOINFOHEADER 構造体とその関連データを作成するのに必要なサイズ (バイト単位) を調べる。

構文

LONG GetBitmapFormatSize(
  const BITMAPINFOHEADER *pHeader
  );

パラメータ

pHeader
Win32 BITMAPINFOHEADER 構造体へのポインタ。

戻り値

この BITMAPINFOHEADER によって記述された VIDEOINFOHEADER 構造体のバイト数を返す (プレフィックス情報、BITMAPINFOHEADER フィールド、およびその他の色情報を含む)。

GetBitmapPalette

ビデオ関数とイメージ関数

VIDEOINFOHEADER 構造体の最初のパレットを取得する。

構文

const RGBQUAD * GetBitmapPalette(
  const VIDEOINFOHEADER *pVideoInfo
  );

パラメータ

pVideoInfo
VIDEOINFOHEADER 構造体へのポインタ。

戻り値

パレットの最初のエントリへのポインタ。

GetBitmapSize

ビデオ関数とイメージ関数

イメージを保持するのに必要なバイト数を調べる。

構文

DWORD GetBitmapSize(
  const BITMAPINFOHEADER *pHeader
  );

パラメータ

pHeader
Win32 BITMAPINFOHEADER 構造体へのポインタ。

戻り値

イメージを保持するのに必要なバイト数を返す。

GetBitmapSubtype

ビデオ関数とイメージ関数

指定されたビットマップのサブタイプを調べる。

構文

const GUID GetBitmapSubtype(
  const BITMAPINFOHEADER *pHeader
  );

パラメータ

pHeader
Win32 BITMAPINFOHEADER 構造体へのポインタ。

戻り値

pHeader によって指定されたビットマップのビデオ サブタイプ GUID を返す。pHeader が NULL の場合は、GUID_NULL を返す。

GetSubtypeName

ビデオ関数とイメージ関数

任意の GUID サブタイプの名前を取得する。

構文

TCHAR * GetSubtypeName(
  const GUID *pSubtype
  );

パラメータ

pSubtype
任意のビデオ サブタイプの GUID へのポインタ。

戻り値

この GUID のデバッグ名を返す。名前が不明の場合は、UNKNOWN を返す。

GetTrueColorType

ビデオ関数とイメージ関数

指定された 16 ビット色ビットマップのサブタイプを調べる。

構文

const GUID GetTrueColorType(
  const BITMAPINFOHEADER *pHeader
  );

パラメータ

pHeader
Win32 BITMAPINFOHEADER 構造体へのポインタ。

戻り値

pHeader によって指定された 16 ビット色ビットマップのビデオ サブタイプ GUID を返す。pHeader が NULL の場合は、GUID_NULL を返す。

HEADER

ビデオ関数とイメージ関数

指定されたビデオ イメージからイメージ データへのポインタを取得する。

構文

HEADER(
  pVideoInfo
  )

パラメータ

pVideoInfo
ビデオ イメージを指定する VIDEOINFOHEADER 構造体へのポインタ。

戻り値

VIDEOINFOHEADER 構造体の bmiHeader データ メンバに含まれる Win32 BITMAPINFOHEADER 構造体へのポインタを返す。

MPEG1_SEQUENCE_INFO

ビデオ関数とイメージ関数

指定された MPEG-1 ビデオ イメージのシーケンス ヘッダーを取得する。

構文

MPEG1_SEQUENCE_INFO(
  pv
  )

パラメータ

pv
MPEG1VIDEOINFO 構造体へのポインタ。

戻り値

指定された MPEG1VIDEOINFO 構造体の bSequenceHeader データ メンバを返す。

PALETTISED

ビデオ関数とイメージ関数

ビデオ イメージのカラー パレットが 8 ビット以下であるかどうかをチェックする。

構文

PALETTISED(
  pbmi
  )

パラメータ

pbmi
ビデオ イメージを指定する Win32 BITMAPINFOHEADER 構造体へのポインタ。

戻り値

ビデオ イメージのパレットが 256 色以下の色を含んでいる場合はゼロ以外の値を返し、それ以外の場合はゼロを返す。

PALETTE_ENTRIES

ビデオ関数とイメージ関数

ビデオ イメージのパレットの色の数を取得する。

構文

PALETTE_ENTRIES(
  pbmi
  )

パラメータ

pbmi
ビデオ イメージを指定する Win32 BITMAPINFOHEADER 構造体へのポインタ。

戻り値

ビデオ イメージのパレットの色の数を返す。

RESET_MASKS

指定されたビデオ イメージのビットマスクをクリアする。

構文

RESET_MASKS(
  pbmi
  )

パラメータ

pbmi
ビデオ イメージを指定する Win32 BITMAPINFOHEADER 構造体へのポインタ。

戻り値

戻り値なし。

RESET_HEADER

ビデオ関数とイメージ関数

指定されたビデオ イメージをクリアする。

構文

RESET_HEADER(
  pbmi
  )

パラメータ

pbmi
ビデオ イメージを指定する Win32 BITMAPINFOHEADER 構造体へのポインタ。

戻り値

戻り値なし。

RESET_PALETTE

ビデオ関数とイメージ関数

指定されたビデオ イメージのカラー パレットをクリアする。

構文

RESET_PALETTE(
  pbmi
  )

パラメータ

pbmi
ビデオ イメージを指定する Win32 BITMAPINFOHEADER 構造体へのポインタ。

戻り値

戻り値なし。

SIZE_EGA_PALETTE

ビデオ関数とイメージ関数

4 ビット カラー パレットのサイズを計算する。

構文

SIZE_EGA_PALETTE

戻り値

16 色パレットのサイズをバイト単位で返す。

SIZE_MASKS

ビデオ関数とイメージ関数

ビットマスクのカラー パレットのサイズを計算する。

構文

SIZE_MASKS

戻り値

3 色を持つビットマップ マスクのカラー パレットのサイズをバイト単位で返す。

SIZE_MPEG1VIDEOINFO

ビデオ関数とイメージ関数

指定された MPEG-1 ビデオ イメージのサイズを計算する。

構文

SIZE_MPEG1VIDEOINFO(
  pv
  )

パラメータ

pv
ビデオ イメージを指定する MPEG1VIDEOINFO 構造体へのポインタ。

戻り値

指定された MPEG1VIDEOINFO 構造体のバイト サイズを返す。

SIZE_PALETTE

ビデオ関数とイメージ関数

8 ビット カラー パレットのサイズを計算する。

構文

SIZE_PALETTE

戻り値

256 色パレットのサイズを返す。

SIZE_PREHEADER

ビデオ関数とイメージ関数

ビデオ イメージのビットマップ情報のバイト オフセットを計算する。

構文

SIZE_PREHEADER

戻り値

VIDEOINFOHEADER 構造体の bmiHeader データ メンバのバイト オフセットを返す。

SIZE_VIDEOHEADER

ビデオ関数とイメージ関数

ビデオ イメージのサイズを計算する。

構文

SIZE_VIDEOHEADER

戻り値

VIDEOINFOHEADER 構造体のすべてのデータ メンバの合計サイズを返す。

TRUECOLORINFO

ビデオ関数とイメージ関数

指定されたビデオ イメージのカラー パレットおよびビットマスクを取得する。

構文

TRUECOLORINFO(
  pbmi
  )

パラメータ

pbmi
ビデオ イメージを含む Win32 VIDEOINFOHEADER 構造体へのポインタ。

戻り値

指定された VIDEOINFOHEADER 構造体のビットマスクおよびカラー パレットを記述する TRUECOLORINFO 構造体の配列へのポインタを取得する。