다음을 통해 공유

IDirectDrawSurface7::SetSurfaceDesc 메서드(ddraw.h)

  • 아티클

기존 표면의 특성을 설정합니다.

구문

HRESULT SetSurfaceDesc(
  [in] LPDDSURFACEDESC2 unnamedParam1,
  [in] DWORD            unnamedParam2
);

매개 변수

[in] unnamedParam1

새 표면 특성을 포함하는 DDSURFACEDESC2 구조체에 대한 포인터입니다.

[in] unnamedParam2

현재 사용되지 않으며 0으로 설정해야 합니다.

반환 값

메서드가 성공하면 반환 값이 DD_OK.

실패하면 메서드는 다음 오류 값 중 하나를 반환할 수 있습니다.

  • DDERR_INVALIDPARAMS
  • DDERR_INVALIDOBJECT
  • DDERR_SURFACELOST
  • DDERR_SURFACEBUSY
  • DDERR_INVALIDSURFACETYPE
  • DDERR_INVALIDPIXELFORMAT
  • DDERR_INVALIDCAPS
  • DDERR_UNSUPPORTED
  • DDERR_GENERIC

설명

현재 SetSurfaceDesc 만 사용하여 명시적 시스템 메모리 표면에서 사용되는 표면 데이터 및 픽셀 형식을 설정할 수 있습니다. 이는 표면이 복사하지 않고 이전에 할당된 버퍼의 데이터를 사용할 수 있기 때문에 유용합니다. 새 표면 메모리는 클라이언트 애플리케이션에 의해 할당되므로 클라이언트 애플리케이션도 할당을 취소해야 합니다.

DirectDrawSurface 개체는 할당하지 않은 표면 메모리의 할당을 취소하지 않습니다. 따라서 표면 메모리가 더 이상 필요하지 않은 경우 할당을 취소해야 합니다. 그러나 SetSurfaceDesc를 호출하면 DirectDraw는 표면을 만들 때 암시적으로 할당된 원래 표면 메모리를 해제합니다.

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 ddraw.h
라이브러리 Ddraw.lib
DLL Ddraw.dll

추가 정보

IDirectDrawSurface7