IDirectDraw7 인터페이스(ddraw.h)
애플리케이션은 IDirectDraw7 인터페이스의 메서드를 사용하여 DirectDraw 개체를 만들고 시스템 수준 변수를 사용합니다. 이 섹션은 IDirectDraw7 인터페이스의 메서드에 대한 참조입니다.
상속
IDirectDraw7 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IDirectDraw7 에는 다음과 같은 유형의 멤버도 있습니다.
메서드
IDirectDraw7 인터페이스에는 이러한 메서드가 있습니다.
| IDirectDraw7::Compact 현재 이 메서드는 구현되지 않습니다. (IDirectDraw7.Compact) |
| IDirectDraw7::CreateClipper DirectDrawClipper 개체를 만듭니다. |
| IDirectDraw7::CreatePalette 이 DirectDraw 개체에 대한 DirectDrawPalette 개체를 만듭니다. |
| IDirectDraw7::CreateSurface 이 DirectDraw 개체에 대한 DirectDrawSurface 개체를 만듭니다. |
| IDirectDraw7::D uplicateSurface DirectDrawSurface 개체를 복제합니다. |
| IDirectDraw7::EnumDisplayModes 하드웨어가 DirectDraw 개체를 통해 노출하고 제공된 표면 설명과 호환되는 모든 디스플레이 모드를 열거합니다. |
| IDirectDraw7::EnumSurfaces 지정된 표면 설명을 충족하는 모든 기존 또는 가능한 표면을 열거합니다. |
| IDirectDraw7::EvaluateMode IDirectDraw7::StartModeTest를 호출한 후 테스트가 제공하는 각 모드를 통과하거나 실패하고 테스트가 완료될 때까지 모드를 단계별로 진행하는 데 사용됩니다. |
| IDirectDraw7::FlipToGDISurface GDI가 기본 표면에 쓰는 표면을 만듭니다. |
| IDirectDraw7::GetAvailableVidMem 사용 가능한 총 디스플레이 메모리 양과 지정된 유형의 표면에 대해 현재 사용 가능한 디스플레이 메모리 양을 검색합니다. |
| IDirectDraw7::GetCaps 하드웨어 및 HEL(하드웨어 에뮬레이션 계층)에 대한 디바이스 드라이버의 기능을 검색합니다. |
| IDirectDraw7::GetDeviceIdentifier 디바이스 드라이버에 대한 정보를 가져옵니다. 이 메서드는 드라이버 또는 칩셋 동작 불량에 대한 해결 방법을 구현하기 위해 특정 하드웨어 설치를 인식하기 위해 주의해서 사용할 수 있습니다. |
| IDirectDraw7::GetDisplayMode 현재 표시 모드를 검색합니다. |
| IDirectDraw7::GetFourCCCodes DirectDraw 개체에서 지원하는 4자 코드(FOURCC)를 검색합니다. 이 메서드는 지원되는 코드 수를 검색할 수도 있습니다. |
| IDirectDraw7::GetGDISurface 현재 GDI가 주 표면으로 처리하는 표면 메모리를 나타내는 DirectDrawSurface 개체를 검색합니다. |
| IDirectDraw7::GetMonitorFrequency DirectDraw 개체가 제어하는 모니터의 빈도를 검색합니다. |
| IDirectDraw7::GetScanLine 현재 모니터에 그려지고 있는 검사 선을 검색합니다. |
| IDirectDraw7::GetSurfaceFromDC GDI 디바이스 컨텍스트 핸들에 따라 표면에 대한 IDirectDrawSurface7 인터페이스를 검색합니다. |
| IDirectDraw7::GetVerticalBlankStatus 세로 공백의 상태를 검색합니다. |
| IDirectDraw7::Initialize CoCreateInstance COM 함수를 사용하여 만든 DirectDraw 개체를 초기화합니다. |
| IDirectDraw7::RestoreAllSurfaces DirectDraw 개체에 대해 생성된 모든 표면을 생성된 순서대로 복원합니다. |
| IDirectDraw7::RestoreDisplayMode 기본 표면의 디스플레이 디바이스 하드웨어 모드를 IDirectDraw7::SetDisplayMode 메서드가 호출되기 전의 모드로 다시 설정합니다. 이 메서드를 사용하려면 단독 수준 액세스가 필요합니다. |
| IDirectDraw7::SetCooperativeLevel 애플리케이션의 최상위 동작을 결정합니다. |
| IDirectDraw7::SetDisplayMode 디스플레이 디바이스 하드웨어의 모드를 설정합니다. |
| IDirectDraw7::StartModeTest 현재 디스플레이 어댑터 및 모니터 조합에 대한 새로 고침 빈도 정보로 시스템 레지스트리를 업데이트하는 테스트를 시작합니다. |
| IDirectDraw7::TestCooperativeLevel 창 또는 전체 화면 애플리케이션에 대한 DirectDraw 디바이스의 현재 협력 수준 상태를 보고합니다. |
| IDirectDraw7::WaitForVerticalBlank 애플리케이션이 세로 공백 간격과 동기화하는 데 도움이 됩니다. |
설명
IDirectDraw7 인터페이스의 메서드는 다음 그룹으로 구성할 수 있습니다.
| 그룹 | 메서드 |
|---|---|
| 메모리 할당 | 압축 및 초기화 |
| 협력 수준 | SetCooperativeLevel 및 TestCooperativeLevel |
| 개체 만들기 | CreateClipper, CreatePalette 및 CreateSurface |
| 장치 접근 권한 값 | GetCaps |
| 디스플레이 모드 | EnumDisplayModes, GetDisplayMode, GetMonitorFrequency, RestoreDisplayMode, SetDisplayMode 및 WaitForVerticalBlank |
| 표시 상태 | GetScanLine 및 GetVerticalBlankStatus |
| 기타 | EvaluateMode, GetAvailableVidMem, GetDeviceIdentifier, GetFourCCCodes 및 StartModeTest |
| Surface 관리 | DuplicateSurface, EnumSurfaces, FlipToGDISurface, GetGDISurface, GetSurfaceFromDC 및 RestoreAllSurfaces |
IDirectDraw7 인터페이스는 이전 버전보다 더 유연한 표면 관리를 가능하게 하는 메서드를 제공하여 이전 버전의 인터페이스 기능을 확장합니다. IDirectDraw7 인터페이스의 모든 표면 관련 메서드는 IDirectDraw2 인터페이스의 매개 변수와 약간 다른 매개 변수를 허용합니다. IDirectDraw2 인터페이스 메서드가 DDSURFACEDESC 구조를 수락하고 IDirectDrawSurface3 인터페이스를 검색할 수 있는 경우 IDirectDraw7의 메서드는 DDSURFACEDESC2 구조를 수락하고 대신 IDirectDrawSurface7 인터페이스를 검색합니다.
IDirectDraw7 에서는 자식 개체의 수명을 지정하는 COM 규칙 준수가 향상되었습니다.
LPDIRECTDRAW, LPDIRECTDRAW2, LPDIRECTDRAW4 또는 LPDIRECTDRAW7 데이터 형식을 사용하여 IDirectDraw, IDirectDraw2, IDirectDraw4 또는 IDirectDraw7 인터페이스에 대한 포인터가 포함된 변수를 선언합니다. Ddraw.h 헤더 파일은 다음 코드를 사용하여 이러한 데이터 형식을 선언합니다.
typedef struct IDirectDraw FAR *LPDIRECTDRAW;
typedef struct IDirectDraw2 FAR *LPDIRECTDRAW2;
typedef struct IDirectDraw4 FAR *LPDIRECTDRAW4;
typedef struct IDirectDraw7 FAR *LPDIRECTDRAW7;
요구 사항
| 대상 플랫폼 | Windows |
| 헤더 | ddraw.h |