VMRALPHABITMAP 結構 (strmif.h)

[與此頁面相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式代碼盡可能重寫為使用新的 API。

當應用程式提供要在複合視訊畫面上顯示的靜態 Alpha 混合位圖時， 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。 如果表面包含每圖元 Alpha，請勿在 dwFlags 中設定VMRBITMAP_SRCCOLORKEY旗標。

rSrc

指定 GDI 裝置內容或 DirectDraw 介面中的來源矩形。

rDest

指定組合空間中的目的地矩形。

fAlpha

指定 Alpha 混合值;必須是從 0.0 到 1.0 的值， (包含) 。

clrSrcKey

指定來源色彩索引鍵。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	strmif.h (包含 Dshow.h)

另請參閱

DirectShow 結構