다음을 통해 공유

DD_UPDATEOVERLAYDATA 구조체(ddrawint.h)

  • 아티클

DD_UPDATEOVERLAYDATA 구조에는 오버레이 표면을 업데이트하는 데 필요한 정보가 포함되어 있습니다.

구문

typedef struct _DD_UPDATEOVERLAYDATA {
  PDD_DIRECTDRAW_GLOBAL lpDD;
  PDD_SURFACE_LOCAL     lpDDDestSurface;
  RECTL                 rDest;
  PDD_SURFACE_LOCAL     lpDDSrcSurface;
  RECTL                 rSrc;
  DWORD                 dwFlags;
  DDOVERLAYFX           overlayFX;
  HRESULT               ddRVal;
  VOID                  *UpdateOverlay;
} *PDD_UPDATEOVERLAYDATA, DD_UPDATEOVERLAYDATA;

멤버

lpDD

드라이버의 디바이스를 설명하는 DD_DIRECTDRAW_GLOBAL 구조를 가리킵니다.

lpDDDestSurface

오버레이할 Microsoft DirectDraw 표면을 나타내는 DD_SURFACE_LOCAL 구조를 가리킵니다. DDOVER_HIDE dwFlags에 지정된 경우 이 값은 NULL일 수 있습니다.

rDest

대상 표면에서 오버레이할 영역의 x, y, 너비 및 높이를 포함하는 RECTL 구조를 지정합니다.

lpDDSrcSurface

오버레이 표면을 설명하는 DD_SURFACE_LOCAL 구조를 가리킵니다.

rSrc

오버레이에 사용할 원본 표면의 영역의 x, y, 너비 및 높이를 포함하는 RECTL 구조를 지정합니다.

dwFlags

드라이버가 오버레이를 처리하는 방법을 지정합니다. 이 멤버는 다음 플래그의 조합일 수 있습니다.

플래그 의미
DDOVER_ADDDIRTYRECT 드라이버에서 무시해야 합니다.
DDOVER_AUTOFLIP 드라이버는 하드웨어 비디오 포트가 자동으로 플리핑할 때마다 오버레이를 자동으로 플리핑해야 합니다. VPE(비디오 포트 확장)를 지원하는 드라이버는 이 플래그를 검사만 필요합니다.
DDOVER_BOB 드라이버는 불안한 아티팩트 발생 없이 VPE 개체 데이터의 각 필드를 개별적으로 표시해야 합니다. 이 플래그는 커널 모드 비디오 전송 기능을 사용하여 커널 모드에서 자체 대칭 이동하려는 VPE 및 디코더와 관련이 있습니다.
DDOVER_BOBHARDWARE bob이 소프트웨어 또는 에뮬레이션이 아닌 하드웨어에서 수행됨을 나타냅니다. VPE를 지원하는 드라이버는 이 플래그를 검사만 필요합니다.
DDOVER_DDFX 드라이버는 overlayFX 멤버에 지정된 특성을 사용하여 오버레이 표면을 표시해야 합니다.
DDOVER_HIDE 드라이버는 오버레이를 숨겨야 합니다. 즉, 드라이버가 이 오버레이를 해제해야 합니다.
DDOVER_INTERLEAVED 오버레이 표면은 인터리브 필드로 구성됩니다. VPE를 지원하는 드라이버는 이 플래그를 검사만 필요합니다.
DDOVER_KEYDEST 드라이버는 대상 표면과 연결된 색 키를 사용해야 합니다.
DDOVER_KEYDESTOVERRIDE 드라이버는 DDOVERLAYFX 구조체의 dckDestColorKey 멤버(DirectDraw SDK 설명서에 설명됨)를 대상 화면과 연결된 색 키 대신 대상 색 키로 사용해야 합니다.
DDOVER_KEYSRC 드라이버는 대상 표면과 연결된 색 키를 사용해야 합니다.
DDOVER_KEYSRCOVERRIDE 드라이버는 DDOVERLAYFX 구조체의 dckSrcColorKey 멤버(DirectDraw SDK 설명서에 설명됨)를 대상 표면과 연결된 색 키 대신 원본 색 키로 사용해야 합니다.
DDOVER_OVERRIDEBOBWEAVE Bob/직조 결정은 다른 인터페이스에 의해 재정의되어서는 안 됩니다. 오버레이 믹서가 이 플래그를 설정하는 경우 DirectDraw는 커널 모드 드라이버가 커널 모드 비디오 전송 기능을 사용하여 하드웨어를 bob 모드와 직조 모드 간에 전환하는 것을 허용하지 않습니다.
DDOVER_REFRESHALL 드라이버에서 무시해야 합니다.
DDOVER_REFRESHDIRTYRECTS 드라이버에서 무시해야 합니다.
DDOVER_SHOW 드라이버에 오버레이가 표시되어야 합니다. 즉, 드라이버가 이 오버레이를 켜야 합니다.

overlayFX

드라이버가 오버레이를 업데이트하는 데 사용해야 하는 추가 효과를 설명하는 DDOVERLAYFX 구조체(DirectDraw SDK 설명서에 설명됨)를 지정합니다. 드라이버는 DDOVER_DDFX, DDOVER_KEYDESTOVERRIDE 또는 DDOVER_KEYSRCOVERRIDE 중 하나가 dwFlags 멤버에 설정된 경우에만 이 구조를 사용해야 합니다.

ddRVal

드라이버가 DdUpdateOverlay 콜백의 반환 값을 쓰는 위치를 지정합니다. DD_OK 반환 코드는 성공을 나타냅니다. 자세한 내용은 DirectDraw에 대한 반환 값을 참조하세요.

UpdateOverlay

DirectDraw API에서 사용되며 드라이버에서 입력하면 안 됩니다.

요구 사항

   
머리글 ddrawint.h(Winddi.h 포함)

추가 정보

DdUpdateOverlay