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 |