IDirectDrawSurface7 인터페이스(ddraw.h)

애플리케이션은 IDirectDrawSurface7 인터페이스의 메서드를 사용하여 DirectDrawSurface 개체를 만들고 시스템 수준 변수를 사용합니다. 이 섹션은 이 인터페이스의 메서드에 대한 참조입니다.

상속

IDirectDrawSurface7 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IDirectDrawSurface7 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IDirectDrawSurface7 인터페이스에는 이러한 메서드가 있습니다.

IDirectDrawSurface7::AddAttachedSurface 지정된 z 버퍼 표면을 이 표면에 연결합니다.
IDirectDrawSurface7::AddOverlayDirtyRect IDirectDrawSurface7::AddOverlayDirtyRect 메서드는 현재 구현되지 않았습니다.
IDirectDrawSurface7::Blt 비트 블록 전송(비트blt)을 수행합니다. 이 메서드는 비트blt 작업 중에 z 버퍼링 또는 알파 혼합을 지원하지 않습니다.
IDirectDrawSurface7::BltBatch IDirectDrawSurface7::BltBatch 메서드는 현재 구현되지 않았습니다.
IDirectDrawSurface7::BltFast 원본 색 키 또는 대상 색 키를 사용하여 원본 복사 비트blt 또는 투명 비트블렛을 수행합니다.
IDirectDrawSurface7::ChangeUniquenessValue 이 표면의 고유성 값을 수동으로 업데이트합니다.
IDirectDrawSurface7::D eleteAttachedSurface 하나 이상의 연결된 표면을 분리합니다.
IDirectDrawSurface7::EnumAttachedSurfaces 이 표면에 연결된 모든 표면을 열거합니다.
IDirectDrawSurface7::EnumOverlayZOrders 지정된 대상의 오버레이 표면을 열거합니다. 오버레이를 앞뒤 또는 백투트 순서로 열거할 수 있습니다.
IDirectDrawSurface7::Flip DDSCAPS_BACKBUFFER 표면과 연결된 표면 메모리를 전면 버퍼 표면과 연결합니다.
IDirectDrawSurface7::FreePrivateData 이 표면과 연결된 지정된 개인 데이터를 해제합니다.
IDirectDrawSurface7::GetAttachedSurface 지정된 기능이 있는 연결된 표면을 가져오고 검색된 인터페이스의 참조 수를 증분합니다.
IDirectDrawSurface7::GetBltStatus 비트 블록 전송(bitblt) 작업에 대한 상태를 가져옵니다.
IDirectDrawSurface7::GetCaps 이 표면의 기능을 검색합니다. 이러한 기능이 반드시 디스플레이 디바이스의 기능과 관련이 있는 것은 아닙니다.
IDirectDrawSurface7::GetClipper 이 표면과 연결된 DirectDrawClipper 개체를 검색하고 반환된 클리퍼의 참조 수를 증분합니다.
IDirectDrawSurface7::GetColorKey 이 표면의 색 키 값을 검색합니다.
IDirectDrawSurface7::GetDC 이 화면에 대한 디바이스 컨텍스트의 GDI 호환 핸들을 만듭니다.
IDirectDrawSurface7::GetDDInterface 이 표면을 만드는 데 사용된 DirectDraw 개체에 대한 인터페이스를 검색합니다.
IDirectDrawSurface7::GetFlipStatus 이 표면이 대칭 이동 프로세스를 완료했는지 여부에 대한 상태를 검색합니다.
IDirectDrawSurface7::GetLOD 관리되는 Mipmap 표면에 대해 현재 설정된 최대 LOD(세부 수준)를 검색합니다. 이 메서드는 관리되는 텍스처에서만 성공합니다.
IDirectDrawSurface7::GetOverlayPosition 이 표면의 표시 좌표를 검색합니다. 이 메서드는 표시되는 활성 오버레이 표면(즉, DDSCAPS_OVERLAY 플래그가 설정된 표면)에서 사용됩니다.
IDirectDrawSurface7::GetPalette 이 표면과 연결된 DirectDrawPalette 개체를 검색하고 반환된 팔레트의 참조 수를 증분합니다.
IDirectDrawSurface7::GetPixelFormat 이 표면의 색 및 픽셀 형식을 검색합니다.
IDirectDrawSurface7::GetPriority 이 텍스처의 텍스처 관리 우선 순위를 검색합니다. 이 메서드는 관리되는 텍스처에서만 성공합니다.
IDirectDrawSurface7::GetPrivateData 이 표면과 연결된 개인 데이터를 제공된 버퍼에 복사합니다.
IDirectDrawSurface7::GetSurfaceDesc 현재 상태에서 이 표면에 대한 설명을 검색합니다.
IDirectDrawSurface7::GetUniquenessValue 이 표면의 현재 고유성 값을 검색합니다.
IDirectDrawSurface7::Initialize DirectDrawSurface 개체를 초기화합니다.
IDirectDrawSurface7::IsLost DirectDrawSurface 개체와 연결된 표면 메모리가 해제되었는지 여부를 확인합니다.
IDirectDrawSurface7::Lock 표면 메모리에 대한 포인터를 가져옵니다.
IDirectDrawSurface7::P ageLock 시스템 메모리와 직접 메모리 액세스(DMA) 전송을 사용하는 비트 블록 전송(bitblt) 작업이 진행 중인 동안 시스템 메모리 표면이 페이징되지 않도록 합니다.
IDirectDrawSurface7::P ageUnlock 시스템 메모리 표면의 잠금을 해제한 다음 페이징할 수 있습니다.
IDirectDrawSurface7::ReleaseDC IDirectDrawSurface7::GetDC 메서드를 사용하여 이전에 가져온 디바이스 컨텍스트의 핸들을 해제합니다.
IDirectDrawSurface7::Restore 손실된 표면을 복원합니다. DirectDrawSurface 개체와 연결된 표면 메모리가 해제된 경우에 발생합니다.
IDirectDrawSurface7::SetClipper clipper 개체를 이 표면에 연결하거나 삭제합니다.
IDirectDrawSurface7::SetColorKey 하드웨어가 표면별로 색 키를 지원하는 경우 DirectDrawSurface 개체의 색 키 값을 설정합니다.
IDirectDrawSurface7::SetLOD 관리되는 Mipmap 표면의 최대 LOD(세부 수준)를 설정합니다. 이 메서드는 관리되는 텍스처에서만 성공합니다.
IDirectDrawSurface7::SetOverlayPosition 오버레이 표면의 디스플레이 좌표를 변경합니다.
IDirectDrawSurface7::SetPalette 색상표 개체를 표면에 연결하거나 표면에서 분리합니다. 표면은 모든 후속 작업에 이 팔레트를 사용합니다. 색상표 변경은 새로 고침 타이밍과 관계없이 즉시 발생합니다.
IDirectDrawSurface7::SetPriority 이 텍스처의 텍스처 관리 우선 순위를 할당합니다. 이 메서드는 관리되는 텍스처에서만 성공합니다.
IDirectDrawSurface7::SetPrivateData DirectDraw가 아닌 애플리케이션에서 사용하기 위한 표면과 데이터를 연결합니다. 데이터는 값으로 전달되며 여러 데이터 집합을 단일 표면과 연결할 수 있습니다.
IDirectDrawSurface7::SetSurfaceDesc 기존 표면의 특성을 설정합니다.
IDirectDrawSurface7::Unlock DirectDraw에 직접 표면 조작이 완료되었다는 것을 알립니다.
IDirectDrawSurface7::UpdateOverlay 오버레이 표면의 시각적 특성을 변경하거나 수정합니다. 이러한 표면에는 DDSCAPS_OVERLAY 플래그가 설정되어 있어야 합니다.
IDirectDrawSurface7::UpdateOverlayDisplay IDirectDrawSurface7::UpdateOverlayDisplay 메서드는 현재 구현되지 않았습니다.
IDirectDrawSurface7::UpdateOverlayZOrder 오버레이의 z 순서를 설정합니다.

설명

IDirectDrawSurface7 인터페이스의 메서드는 다음 그룹으로 구성할 수 있습니다.

그룹	메서드
메모리 할당	초기화, IsLost 및 복원
표면 연결	AddAttachedSurface, DeleteAttachedSurface, EnumAttachedSurfaces 및 GetAttachedSurface
BitBltting	Blt, BltBatch, BltFast 및 GetBltStatus
색 키 지정	GetColorKey 및 SetColorKey
디바이스 컨텍스트	GetDC 및 ReleaseDC
내리고	Flip 및 GetFlipStatus
잠금 화면	잠금, PageLock, PageUnlock 및 잠금 해제
기타	GetDDInterface
오버레이	AddOverlayDirtyRect, EnumOverlayZOrders, GetOverlayPosition, SetOverlayPosition, UpdateOverlay, UpdateOverlayDisplay 및 UpdateOverlayZOrder
개인 표면 데이터	FreePrivateData, GetPrivateData 및 SetPrivateData
Surface 기능	GetCaps
Surface clipper	GetClipper 및 SetClipper
Surface 특성	ChangeUniquenessValue, GetPixelFormat, GetSurfaceDesc, GetUniquenessValue 및 SetSurfaceDesc
Surface 색상표	GetPalette 및 SetPalette
텍스처	GetLOD, GetPriority, SetLOD 및 SetPriority

 

IDirectDrawSurface7 인터페이스는 더 나은 표면 관리 및 사용 편의성을 제공하는 메서드를 제공하여 이전 버전의 인터페이스 기능을 확장합니다. 이 인터페이스의 많은 메서드는 이전 버전의 인터페이스에서 해당 매개 변수와 약간 다른 매개 변수를 허용합니다. IDirectDrawSurface3 인터페이스 메서드가 DDSURFACEDESC 구조체 또는 IDirectDrawSurface3 인터페이스를 수락할 수 있는 경우 IDirectDrawSurface7의 메서드는 DDSURFACEDESC2 구조체 또는 IDirectDrawSurface7 인터페이스를 대신 수락합니다.

LPDIRECTDRAWSURFACE, LPDIRECTDRAWSURFACE2, LPDIRECTDRAWSURFACE3, LPDIRECTDRAWSURFACE4 또는 LPDIRECTDRAWSURFACE7 데이터 형식을 사용하여 다양한 DirectDrawSurface 개체 인터페이스를 가리키는 변수를 선언합니다. Ddraw.h 헤더 파일은 다음 코드를 사용하여 이러한 데이터 형식을 선언합니다.

typedef struct IDirectDrawSurface     FAR *LPDIRECTDRAWSURFACE;
typedef struct IDirectDrawSurface2    FAR *LPDIRECTDRAWSURFACE2;
typedef struct IDirectDrawSurface3    FAR *LPDIRECTDRAWSURFACE3;
typedef struct IDirectDrawSurface4    FAR *LPDIRECTDRAWSURFACE4;
typedef struct IDirectDrawSurface7    FAR *LPDIRECTDRAWSURFACE7;

요구 사항

대상 플랫폼	Windows
헤더	ddraw.h