VMRALPHABITMAP 구조체(strmif.h)

  • 아티클

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드가 DirectShow 대신 Media Foundation에서 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 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 [데스크톱 앱만 해당]
머리글 strmif.h(Dshow.h 포함)

추가 정보

DirectShow 구조체