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
비트맵을 찾을 위치를 믹서에 지시하는 플래그입니다. 다음 값이 정의됩니다.
| 값 | 의미 |
|---|---|
|
비트맵을 사용하지 않도록 설정합니다. 이 플래그는 다른 플래그와 결합할 수 없습니다. |
|
HDC에서 비트맵을 가져옵니다. 이 플래그가 설정된 경우 hdc 멤버는 디바이스 컨텍스트에 대한 유효한 핸들을 지정해야 하며 pDDS 멤버는 NULL이어야 합니다.
이 플래그가 없으면 pDDS 멤버가 유효한 DirectDraw 표면을 가리킨 다음 hdc 멤버가 NULL이어야 합니다. |
|
전체 DirectDraw 표면을 사용합니다. 이 플래그를 지정하면 rSrc 가 무시됩니다. 이 플래그는 VMRBITMAP_HDC 플래그와 결합할 수 없습니다. |
|
clrSrcKey 값은 유효하며 혼합할 때 사용해야 합니다. |
|
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 포함) |