Share via

VMRALPHABITMAP 構造体 (strmif.h)

  • [アーティクル]

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

VMRALPHABITMAP 構造体は、アプリケーションが複合ビデオ フレームに表示される静的なアルファ ブレンド ビットマップを提供する場合に、VMR-7 フィルターの IVMRMixerBitmap メソッドで使用されます。

構文

typedef struct _VMRALPHABITMAP {
  DWORD                dwFlags;
  HDC                  hdc;
  LPDIRECTDRAWSURFACE7 pDDS;
  RECT                 rSrc;
  NORMALIZEDRECT       rDest;
  FLOAT                fAlpha;
  COLORREF             clrSrcKey;
} VMRALPHABITMAP, *PVMRALPHABITMAP;

メンバー

dwFlags

ビットマップを検索する場所をミキサーに指示するフラグ。 次の値が定義されています。

値 意味
VMRBITMAP_DISABLE
0x00000001
 ビットマップを無効にします。 このフラグを他のフラグと組み合わせることはできません。
VMRBITMAP_HDC
0x00000002
 HDC からビットマップを取得します。 このフラグが設定されている場合、 hdc メンバーはデバイス コンテキストに対する有効なハンドルを指定する必要があり、 pDDS メンバーは NULL である必要があります。

このフラグがない場合、 pDDS メンバーは有効な DirectDraw サーフェスをポイントし、 hdc メンバーは NULL である必要があります。
VMRBITMAP_ENTIREDDS
0x00000004
 DirectDraw サーフェス全体を取得します。 このフラグを指定すると、 rSrc は無視されます。 このフラグを VMRBITMAP_HDC フラグと組み合わせることはできません。
VMRBITMAP_SRCCOLORKEY
0x00000008
 clrSrcKey 値は有効であり、ブレンド時に使用する必要があります。
VMRBITMAP_SRCRECT
0x00000010
 rSrc 四角形が有効であることを示し、ブレンドする元のアプリ イメージのサブ四角形を指定します。

このフラグは IVMRMixerBitmap::UpdateAlphaBitmapParameters メソッドでのみ有効です。 IVMRMixerBitmap::SetAlphaBitmap メソッドの場合、rSrc メンバーはビットマップ全体を参照する必要があります。

hdc

ビットマップのデバイス コンテキストへのハンドル。 ビットマップが DirectDraw サーフェスにある場合は NULL を 指定します。

pDDS

ビットマップを含む DirectDraw サーフェスへのポインター。 GDI デバイス コンテキストからビットマップを取得する場合は NULL を 指定します。 DirectDraw サーフェスを指定する場合、ピクセル形式は ARGB-32 または RGB-32 である必要があります。 サーフェスにピクセルごとのアルファが含まれている場合は、 dwFlags で VMRBITMAP_SRCCOLORKEY フラグを設定しないでください。

rSrc

GDI デバイス コンテキストまたは DirectDraw サーフェイスのソース四角形を指定します。

rDest

合成空間内の移動先の四角形を指定します。

fAlpha

アルファ ブレンド値を指定します。は、0.0 ~ 1.0 (含む) の値である必要があります。

clrSrcKey

ソースカラーキーを指定します。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header strmif.h (Dshow.h を含む)

こちらもご覧ください

DirectShow 構造体