ビデオ関数と画像関数
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]
これらの関数とマクロは、DirectShow ビデオ形式の構造を操作します。
| 関数 | 説明 |
|---|---|
| BIT_MASKS_MATCH | 2 つの VIDEOINFO 構造体のカラー マスクを比較します。 |
| ビットマスク | VIDEOINFO 構造体からカラー マスクを取得します |
| CheckVideoInfoType | VIDEOINFOHEADER 形式の構造体を含むメディアの種類で、バッファー オーバーランや整数オーバーフローの原因となる可能性があるエラーを確認します。 |
| CheckVideoInfo2Type | VIDEOINFOHEADER2 形式の構造体を含むメディアの種類で、バッファー オーバーランや整数オーバーフローの原因となる可能性があるエラーを確認します。 |
| 色 | VIDEOINFO 構造体からパレット エントリを取得します |
| ContainsPalette | 指定した VIDEOINFOHEADER 構造体にパレットが含まれているかどうかを判断します。 |
| ConvertVideoInfoToVideoInfo2 | VIDEOINFOHEADER を使用するメディアの種類を VIDEOINFOHEADER2 を使用するメディアの種類に変換します。 |
| DIBSIZE | デバイスに依存しないビットマップ (DIB) に必要なバイト数を計算します。 |
| GetBitCount | 指定したビデオ サブタイプで使用されるピクセルあたりのビット数を返します。 |
| GetBitmapFormatSize | 指定した BITMAPINFOHEADER 構造体を保持できる VIDEOINFO 構造体に必要なサイズを計算します。 |
| GetBitmapPalette | VIDEOINFOHEADER 構造体の最初のパレット エントリを返します。 |
| GetBitmapSize | デバイスに依存しないビットマップ (DIB) に必要なバイト数を計算します。 |
| GetBitmapSubtype | 指定したビットマップのメディア サブタイプ GUID を 返します。 |
| GetSubtypeName | ビデオ サブタイプの人間が判読できる名前を取得します。 |
| GetTrueColorType | 16 ビットの非圧縮 RGB ビットマップのメディア サブタイプ GUID を 返します。 |
| ヘッダー | VIDEOINFOHEADER 内の BITMAPINFOHEADER のアドレスを返します。 |
| MPEG1_SEQUENCE_INFO | MPEG1VIDEOINFO 構造体内のシーケンス ヘッダーのアドレスを返します。 |
| PALETTISED | ビットマップの色深度が 8 ビット以下かどうかを確認します。 |
| PALETTE_ENTRIES | 指定したビットマップのパレット内の色の最大数を取得します。 |
| RESET_MASKS | VIDEOINFO 構造体のカラー マスク フィールドにゼロを設定します。 |
| RESET_HEADER | VIDEOINFOHEADER にゼロを設定します。 |
| RESET_PALETTE | VIDEOINFO 構造体のパレット エントリにゼロを設定します。 |
| SIZE_EGA_PALETTE | 4 ビット RGB ビットマップ内のパレット エントリに必要なサイズを計算します。 |
| SIZE_MASKS | VIDEOINFO 構造体のカラー マスクのサイズを計算します。 |
| SIZE_MPEG1VIDEOINFO | シーケンス ヘッダーを含む MPEG1VIDEOINFO 構造体のサイズを計算します。 |
| SIZE_PALETTE | は、VIDEOINFO 構造体内のパレット エントリのサイズを計算します。 |
| SIZE_PREHEADER | VIDEOINFOHEADER 構造体内の bmiHeader フィールドのバイト オフセットを計算します。 |
| SIZE_VIDEOHEADER | VIDEOINFOHEADER 構造体のサイズを計算します。 |
| Truecolor | VIDEOINFO 構造体から TRUECOLORINFO 構造体を返します。 |
| ValidateBitmapInfoHeader | バッファー オーバーランまたは整数オーバーフローの原因となる可能性があるエラーがないか 、BITMAPINFOHEADER 構造体をチェックします。 |
解説
このセクションで説明するマクロと関数のほとんどは、RGB ビットマップの VIDEOINFOHEADER および VIDEOINFO 構造体を操作するために設計されています。 これらのマクロは注意して使用してください。ほとんどのマクロは、指定された構造体が正しく初期化されていることを前提としています。 また、それらの多くは BITMAPINFOHEADER 構造体が標準サイズであると想定しています。つまり、 biSize == sizeof(BITMAPINFOHEADER)です。
DirectShow 基本クラス ライブラリには、true 色ビットマップの標準カラー マスクを定義する次のグローバル定数も用意されています。
| グローバル データ | 説明 |
|---|---|
| bits555 | 5- 5-5 形式の 16 ビット RGB ビットマップのカラー マスクの配列。 |
| bits565 | 5 から 6-5 形式の 16 ビット RGB ビットマップのカラー マスクの配列。 |
| bits888 | 24 ビット RGB ビットマップのカラー マスクの配列。 |
これらの各定数は、赤、緑、青のマスクを含む 3 つの DWORDの配列内の順序で指定します。