DDSURFACEDATA 구조체(dxmini.h)

DDSURFACEDATA 구조체는 DirectDraw에서 커널 모드 미니포트 드라이버에 표면을 나타내는 데 사용됩니다.

구문

typedef struct _DDSURFACEDATA {
  DWORD     ddsCaps;
  DWORD     dwSurfaceOffset;
  ULONG_PTR fpLockPtr;
  DWORD     dwWidth;
  DWORD     dwHeight;
  LONG      lPitch;
  DWORD     dwOverlayFlags;
  DWORD     dwOverlayOffset;
  DWORD     dwOverlaySrcWidth;
  DWORD     dwOverlaySrcHeight;
  DWORD     dwOverlayDestWidth;
  DWORD     dwOverlayDestHeight;
  DWORD     dwVideoPortId;
  DWORD     dwFormatFlags;
  DWORD     dwFormatFourCC;
  DWORD     dwFormatBitCount;
  DWORD     dwRBitMask;
  DWORD     dwGBitMask;
  DWORD     dwBBitMask;
  ULONG     dwDriverReserved1;
  ULONG     dwDriverReserved2;
  ULONG     dwDriverReserved3;
  ULONG     dwDriverReserved4;
} DDSURFACEDATA, *LPDDSURFACEDATA;

멤버

ddsCaps

표면을 설명하는 데 사용되는 생성 기능이 포함된 DDSCAPS 구조를 가리킵니다.

dwSurfaceOffset

프레임 버퍼의 시작부터 표면 시작까지의 바이트 오프셋을 지정합니다. 이 필드는 미니포트 드라이버에서만 사용됩니다.

fpLockPtr

표면의 시작을 가리킵니다.

dwWidth

표면 너비를 픽셀 단위로 지정합니다.

dwHeight

표면 높이를 픽셀 단위로 지정합니다.

lPitch

표면 피치(바이트)를 지정합니다.

dwOverlayFlags

DdUpdateOverlay에서 설정한 현재 사용자 모드 DDOVER_Xxx 플래그를 지정하는 플래그 집합을 나타냅니다. 이 멤버는 다음 값 중 비트 OR입니다.

플래그	의미
DDOVER_ADDDIRTYRECT	에뮬레이된 오버레이된 표면에 더티 사각형을 추가합니다.
DDOVER_ALPHADEST	알파 정보를 픽셀 형식으로 사용하거나 대상 표면에 연결된 알파 채널 표면을 이 오버레이의 알파 채널로 사용합니다.
DDOVER_ALPHADESTCONSTOVERRIDE	DDOVERLAYFX 구조체의 dwAlphaDestConst 멤버를 이 오버레이의 대상 알파 채널로 사용합니다. DDOVERLAYFX 구조체는 ddraw.h에 정의되어 있습니다.
DDOVER_ALPHADESTNEG	알파 값이 증가함에 따라 대상 표면이 더 투명해집니다(0은 불투명).
DDOVER_ALPHADESTSURFACEOVERRIDE	DDOVERLAYFX 구조체의 lpDDSAlphaDest 멤버(DirectDraw SDK 설명서에 정의됨)를 이 오버레이의 알파 채널 대상으로 사용합니다.
DDOVER_ALPHAEDGEBLEND	DDOVERLAYFX 구조체의 dwAlphaEdgeBlend 멤버(DirectDraw SDK 설명서에 정의됨)를 색 키 색에 테두리가 있는 이미지 가장자리의 알파 채널로 사용합니다.
DDOVER_ALPHASRC	알파 정보를 픽셀 형식으로 사용하거나 원본 표면에 연결된 알파 채널 표면을 이 오버레이의 원본 알파 채널로 사용합니다.
DDOVER_ALPHASRCCONSTOVERRIDE	DDOVERLAYFX 구조체의 dwAlphaSrcConst 멤버(DirectDraw SDK 설명서에 정의됨)를 이 오버레이의 원본 알파 채널로 사용합니다.
DDOVER_ALPHASRCNEG	알파 값이 증가함에 따라 원본 표면이 더 투명해집니다(0은 불투명).
DDOVER_ALPHASRCSURFACEOVERRIDE	DDOVERLAYFX 구조체의 lpDDSAlphaSrc 멤버(DirectDraw SDK 설명서에 정의됨)를 이 오버레이의 알파 채널 원본으로 사용합니다.
DDOVER_AUTOFLIP	하드웨어 비디오 포트 VSYNC가 발생할 때마다 대칭 이동 체인의 다음 화면으로 자동으로 대칭 이동합니다.
DDOVER_BOB	아티팩트를 유발하지 않고 인터레이스된 비디오 스트림의 각 필드를 개별적으로 표시합니다.
DDOVER_BOBHARDWARE	Bob은 소프트웨어가 아닌 하드웨어를 사용하여 수행되거나 에뮬레이트됩니다.
DDOVER_DDFX	오버레이 FX 플래그를 사용하여 특수 오버레이 효과를 정의합니다.
DDOVER_HIDE	이 오버레이를 끕니다.
DDOVER_INTERLEAVED	표면 메모리는 인터리브 필드로 구성됩니다.
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	이 오버레이를 켭니다.

dwOverlayOffset

프레임 버퍼의 시작부터 오버레이 시작까지의 바이트 오프셋을 지정합니다. 이 필드는 미니포트 드라이버에서만 사용됩니다.

dwOverlaySrcWidth

오버레이 원본 너비를 픽셀 단위로 지정합니다. 이 필드는 미니포트 드라이버에서만 사용됩니다.

dwOverlaySrcHeight

오버레이 원본 높이(픽셀)를 지정합니다. 이 필드는 미니포트 드라이버에서만 사용됩니다.

dwOverlayDestWidth

오버레이 대상 너비를 픽셀 단위로 지정합니다. 이 필드는 미니포트 드라이버에서만 사용됩니다.

dwOverlayDestHeight

오버레이 대상 높이(픽셀)를 지정합니다. 이 필드는 미니포트 드라이버에서만 사용됩니다.

dwVideoPortId

이 표면이 VPE(비디오 포트 확장) 개체에 의해 공급되는 경우 이 필드는 VPE 개체의 ID, 범위의 정수(0 - (최대 하드웨어 비디오 포트 수 -1))를 나타냅니다. 그렇지 않으면 이 필드는 -1입니다.

dwFormatFlags

픽셀 형식 컨트롤 플래그 집합을 지정합니다. 이 멤버는 다음 값 중 비트 OR입니다.

플래그	의미
DDPF_ALPHA	픽셀 형식은 알파 전용 표면을 설명합니다.
DDPF_ALPHAPIXELS	표면에는 픽셀 형식의 알파 채널 정보가 있습니다.
DDPF_ALPHAPREMULT	픽셀의 색 구성 요소는 픽셀의 알파 값으로 미리 곱합니다. 이 플래그가 설정되면 DDPF_ALPHAPIXELS 플래그도 설정해야 합니다. 이 플래그가 설정되지 않았지만 DDPF_ALPHAPIXELS 플래그가 설정된 경우 픽셀 형식의 색 구성 요소는 알파로 미리 곱하지 않습니다. 이 경우 알파 혼합 작업이 수행될 때 색 구성 요소에 알파 값을 곱해야 합니다.
DDPF_BUMPDUDV	픽셀 형식의 범프 맵 dUdV 데이터는 유효합니다.
DDPF_BUMPLUMINANCE	픽셀 형식의 광도 데이터는 유효합니다. 이 플래그는 범프맵 표면에서 광도를 걸 때 사용됩니다. 픽셀의 광도 부분에 대한 비트 마스크는 DDPIXELFORMAT 구조체의 dwBumpLuminanceBitCount 멤버로 표시됩니다.
DDPF_COMPRESSED	Surface는 지정된 형식의 픽셀 데이터를 수락하고 쓰기 작업 중에 압축합니다.
DDPF_FOURCC	FOURCC 코드가 유효합니다.
DDPF_LUMINANCE	픽셀 형식의 광도 데이터가 유효합니다. 이 플래그는 광도 전용 또는 광도 및 알파 표면에 사용됩니다. 비트 깊이는 DDPIXELFORMAT 구조체의 dwLuminanceBitCount 멤버로 표시됩니다.
DDPF_PALETTEINDEXED1	표면이 인덱싱된 1비트 색입니다.
DDPF_PALETTEINDEXED2	표면은 인덱싱된 2비트 색입니다.
DDPF_PALETTEINDEXED4	표면은 인덱싱된 4비트 색입니다.
DDPF_PALETTEINDEXED8	표면이 인덱싱된 8비트 색입니다.
DDPF_PALETTEINDEXEDTO8	표면은 8비트 색상표로 인덱싱된 1비트, 2비트 또는 4비트 색입니다.
DDPF_RGB	픽셀 형식 구조의 RGB 데이터는 유효합니다.
DDPF_RGBTOYUV	Surface는 RGB 데이터를 수락하고 쓰기 작업 중에 YUV 데이터로 변환합니다. 쓸 데이터의 형식은 픽셀 형식 구조에 포함됩니다. DDPF_RGB 플래그가 설정됩니다.
DDPF_STENCILBUFFER	표면에는 Z 정보와 함께 스텐실 정보가 포함됩니다.
DDPF_YUV	픽셀 형식 구조의 YUV 데이터는 유효합니다.
DDPF_ZBUFFER	픽셀 형식은 z 버퍼 전용 표면을 설명합니다.
DDPF_ZPIXELS	표면은 RGBZ 형식입니다.

dwFormatFourCC

FOURCC 코드를 지정합니다.

dwFormatBitCount

픽셀당 비트 수(4, 8, 16, 24 또는 32)를 지정합니다.

dwRBitMask

빨간색 비트 마스크를 지정합니다.

dwGBitMask

녹색 비트 마스크를 지정합니다.

dwBBitMask

파란색 비트 마스크를 지정합니다.

dwDriverReserved1

HAL/미니포트용으로 예약됨

dwDriverReserved2

HAL/미니포트용으로 예약됨

dwDriverReserved3

HAL/미니포트용으로 예약됨

dwDriverReserved4

미니포트 드라이버에서 사용하도록 예약되어 있습니다.

요구 사항

머리글	dxmini.h(Dxmini.h 포함)

추가 정보

DDPIXELFORMAT

DDSCAPS

DdUpdateOverlay