Microsoft DirectX 8.0 |
宣言 : Wxutil.h
Microsoft® DirectShow® 基底クラスの Wxutil.h ヘッダー ファイルは、VIDEOINFOHEADER 構造体と BITMAPINFO 構造体との間で変換を行うのに役立つ関数およびマクロを提供する。
BIT_MASKS_MATCH 2 つのビデオ イメージのマスクを比較する。 BITMASKS 指定された VIDEOINFOHEADER 構造体のビットマスクの配列へのポインタを取得する。 COLORS 指定された VIDEOINFOHEADER 構造体のカラー パレットを記述する RGBQUAD へのポインタを取得する。 ContainsPalette ビデオ イメージにカラー パレットが含まれているかどうかをチェックする。 ConvertVideoInfoToVideoInfo2 VIDEOINFO ストリーム フォーマットを VIDEOINFOHEADER2 フォーマットに変換する。 DIBSIZE 指定されたビットマップのバイト サイズを計算する。 GetBitCount ピクセルあたりのビット数を調べる。 GetBitmapFormatSize VIDEOINFOHEADER 構造体とその関連データを作成するのに必要なサイズ (バイト単位) を調べる。 GetBitmapPalette VIDEOINFOHEADER 構造体の最初のパレット エントリを取得する。 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_PALETTE EGA (4 ビット) カラー パレットのサイズを計算する。 SIZE_MASKS マスクのカラー パレットのサイズを計算する。 SIZE_MPEG1VIDEOINFO 指定された MPEG-1 ビデオ イメージのサイズを計算する。 SIZE_PALETTE 8 ビット カラー パレットのサイズを計算する。 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(
pbmi1,
pbmi2
)
パラメータ
- pbmi1
- 最初のビデオ イメージを含む Win32 VIDEOINFOHEADER 構造体へのポインタ。
- pbmi2
- 2 番目のビデオ イメージを含む Win32 VIDEOINFOHEADER 構造体へのポインタ。
戻り値
両方のビデオ イメージのビットマスクが同じ場合はゼロ以外の値を返し、それ以外の場合はゼロを返す。
指定されたビデオ イメージのビットマスクを取得する。
構文
BITMASKS(
pbmi
)
パラメータ
- pbmi
- ビデオ イメージを含む Win32 VIDEOINFOHEADER 構造体へのポインタ。
戻り値
指定された VIDEOINFOHEADER 構造体のビットマスクの配列へのポインタを返す。
指定されたビデオ イメージのカラー パレットを取得する。
構文
COLORS(
pbmi
)
パラメータ
- pbmi
- ビデオ イメージを含む Win32 VIDEOINFOHEADER 構造体へのポインタ。
戻り値
指定された VIDEOINFOHEADER 構造体のカラー パレットを記述する RGBQUAD 構造体の配列へのポインタを返す。
ビデオ イメージにカラー パレットが含まれているかどうかをチェックする。
構文
BOOL ContainsPalette(
const VIDEOINFOHEADER *pVideoInfo
);
パラメータ
- pVideoInfo
- VIDEOINFOHEADER 構造体へのポインタ。
戻り値
VIDEOINFOHEADER 構造体がカラー パレットを含んでいる場合は TRUE を返し、それ以外の場合は FALSE を返す。
VIDEOINFO ストリーム フォーマットを VIDEOINFOHEADER2 フォーマットに変換する。
構文
STDAPI ConvertVideoInfoToVideoInfo2( AM_MEDIA_TYPE *pmt );
パラメータ
- pmt
- [in/out] AM_MEDIA_TYPE 列挙型へのポインタ。
戻り値
インターフェイスの実装に依存する HRESULT 値を返す。HRESULT には、次のいずれかの標準定数、または一覧にないほかの値が含まれる。
E_OUTOFMEMORY 処理でメモリ不足が発生した。 S_OK 成功。
注意
成功した場合、この関数は AM_MEDIA_TYPE の formattype メンバを変更し、登録された GUID を VIDEOINFO 型から VIDEOINFOHEADER2 型に変更する。
指定された (デバイスに依存しない) ビットマップのバイト サイズを計算する。
構文
DIBSIZE(
bi
)
パラメータ
- bi
- ソース ビットマップを指定する Win32 BITMAPINFOHEADER 構造体。
戻り値
bi パラメータのバイト サイズを返す。
ピクセルあたりのビット数を調べる。
構文
WORD GetBitCount(
const GUID *pSubtype
);
パラメータ
- pSubtype
- 任意の ビデオ サブタイプの GUID へのポインタ。
戻り値
このサブタイプのピクセルあたりのビット数を返す。エラーが発生した場合は、USHRT_MAX を返す。
VIDEOINFOHEADER 構造体とその関連データを作成するのに必要なサイズ (バイト単位) を調べる。
構文
LONG GetBitmapFormatSize(
const BITMAPINFOHEADER *pHeader
);
パラメータ
- pHeader
- Win32 BITMAPINFOHEADER 構造体へのポインタ。
戻り値
この BITMAPINFOHEADER によって記述された VIDEOINFOHEADER 構造体のバイト数を返す (プレフィックス情報、BITMAPINFOHEADER フィールド、およびその他の色情報を含む)。
VIDEOINFOHEADER 構造体の最初のパレットを取得する。
構文
const RGBQUAD * GetBitmapPalette(
const VIDEOINFOHEADER *pVideoInfo
);
パラメータ
- pVideoInfo
- VIDEOINFOHEADER 構造体へのポインタ。
戻り値
パレットの最初のエントリへのポインタ。
イメージを保持するのに必要なバイト数を調べる。
構文
DWORD GetBitmapSize(
const BITMAPINFOHEADER *pHeader
);
パラメータ
- pHeader
- Win32 BITMAPINFOHEADER 構造体へのポインタ。
戻り値
イメージを保持するのに必要なバイト数を返す。
指定されたビットマップのサブタイプを調べる。
構文
const GUID GetBitmapSubtype(
const BITMAPINFOHEADER *pHeader
);
パラメータ
- pHeader
- Win32 BITMAPINFOHEADER 構造体へのポインタ。
戻り値
pHeader によって指定されたビットマップのビデオ サブタイプ GUID を返す。pHeader が NULL の場合は、GUID_NULL を返す。
任意の GUID サブタイプの名前を取得する。
構文
TCHAR * GetSubtypeName(
const GUID *pSubtype
);
パラメータ
- pSubtype
- 任意のビデオ サブタイプの GUID へのポインタ。
戻り値
この GUID のデバッグ名を返す。名前が不明の場合は、UNKNOWN を返す。
指定された 16 ビット色ビットマップのサブタイプを調べる。
構文
const GUID GetTrueColorType(
const BITMAPINFOHEADER *pHeader
);
パラメータ
- pHeader
- Win32 BITMAPINFOHEADER 構造体へのポインタ。
戻り値
pHeader によって指定された 16 ビット色ビットマップのビデオ サブタイプ GUID を返す。pHeader が NULL の場合は、GUID_NULL を返す。
指定されたビデオ イメージからイメージ データへのポインタを取得する。
構文
HEADER(
pVideoInfo
)
パラメータ
- pVideoInfo
- ビデオ イメージを指定する VIDEOINFOHEADER 構造体へのポインタ。
戻り値
VIDEOINFOHEADER 構造体の bmiHeader データ メンバに含まれる Win32 BITMAPINFOHEADER 構造体へのポインタを返す。
指定された MPEG-1 ビデオ イメージのシーケンス ヘッダーを取得する。
構文
MPEG1_SEQUENCE_INFO(
pv
)
パラメータ
- pv
- MPEG1VIDEOINFO 構造体へのポインタ。
戻り値
指定された MPEG1VIDEOINFO 構造体の bSequenceHeader データ メンバを返す。
ビデオ イメージのカラー パレットが 8 ビット以下であるかどうかをチェックする。
構文
PALETTISED(
pbmi
)
パラメータ
- pbmi
- ビデオ イメージを指定する Win32 BITMAPINFOHEADER 構造体へのポインタ。
戻り値
ビデオ イメージのパレットが 256 色以下の色を含んでいる場合はゼロ以外の値を返し、それ以外の場合はゼロを返す。
ビデオ イメージのパレットの色の数を取得する。
構文
PALETTE_ENTRIES(
pbmi
)
パラメータ
- pbmi
- ビデオ イメージを指定する Win32 BITMAPINFOHEADER 構造体へのポインタ。
戻り値
ビデオ イメージのパレットの色の数を返す。
指定されたビデオ イメージのビットマスクをクリアする。
構文
RESET_MASKS(
pbmi
)
パラメータ
- pbmi
- ビデオ イメージを指定する Win32 BITMAPINFOHEADER 構造体へのポインタ。
戻り値
戻り値なし。
指定されたビデオ イメージをクリアする。
構文
RESET_HEADER(
pbmi
)
パラメータ
- pbmi
- ビデオ イメージを指定する Win32 BITMAPINFOHEADER 構造体へのポインタ。
戻り値
戻り値なし。
指定されたビデオ イメージのカラー パレットをクリアする。
構文
RESET_PALETTE(
pbmi
)
パラメータ
- pbmi
- ビデオ イメージを指定する Win32 BITMAPINFOHEADER 構造体へのポインタ。
戻り値
戻り値なし。
4 ビット カラー パレットのサイズを計算する。
構文
SIZE_EGA_PALETTE
戻り値
16 色パレットのサイズをバイト単位で返す。
ビットマスクのカラー パレットのサイズを計算する。
構文
SIZE_MASKS
戻り値
3 色を持つビットマップ マスクのカラー パレットのサイズをバイト単位で返す。
指定された MPEG-1 ビデオ イメージのサイズを計算する。
構文
SIZE_MPEG1VIDEOINFO(
pv
)
パラメータ
- pv
- ビデオ イメージを指定する MPEG1VIDEOINFO 構造体へのポインタ。
戻り値
指定された MPEG1VIDEOINFO 構造体のバイト サイズを返す。
8 ビット カラー パレットのサイズを計算する。
構文
SIZE_PALETTE
戻り値
256 色パレットのサイズを返す。
ビデオ イメージのビットマップ情報のバイト オフセットを計算する。
構文
SIZE_PREHEADER
戻り値
VIDEOINFOHEADER 構造体の bmiHeader データ メンバのバイト オフセットを返す。
ビデオ イメージのサイズを計算する。
構文
SIZE_VIDEOHEADER
戻り値
VIDEOINFOHEADER 構造体のすべてのデータ メンバの合計サイズを返す。
指定されたビデオ イメージのカラー パレットおよびビットマスクを取得する。
構文
TRUECOLORINFO(
pbmi
)
パラメータ
- pbmi
- ビデオ イメージを含む Win32 VIDEOINFOHEADER 構造体へのポインタ。
戻り値
指定された VIDEOINFOHEADER 構造体のビットマスクおよびカラー パレットを記述する TRUECOLORINFO 構造体の配列へのポインタを取得する。