IDirectDraw7::EnumSurfaces 메서드(ddraw.h)
지정된 표면 설명을 충족하는 모든 기존 또는 가능한 표면을 열거합니다.
구문
HRESULT EnumSurfaces(
[in] DWORD unnamedParam1,
[in] LPDDSURFACEDESC2 unnamedParam2,
[in] LPVOID unnamedParam3,
[in] LPDDENUMSURFACESCALLBACK7 unnamedParam4
);
매개 변수
[in] unnamedParam1
하나의 검색 유형 플래그와 일치하는 플래그의 조합입니다. 검색 유형 플래그는 메서드가 일치하는 표면을 검색하는 방법을 결정합니다. lpDDSD2 매개 변수의 설명을 사용하거나 해당 설명과 이미 일치하는 기존 표면을 사용하여 만들 수 있는 표면을 검색할 수 있습니다. 일치 플래그는 메서드가 모든 표면을 열거하는지, 일치하는 표면만 열거하는지, lpDDSD2 매개 변수의 설명과 일치하지 않는 표면만 열거하는지 여부를 결정합니다.
검색 유형 플래그
DDENUMSURFACES_CANBECREATED
만들 수 있는 첫 번째 표면을 열거하고 검색 조건을 충족합니다. 이 플래그는 DDENUMSURFACES_MATCH 플래그에서만 사용할 수 있습니다.
DDENUMSURFACES_DOESEXIST
검색 조건을 충족하는 기존 표면을 열거합니다.
일치하는 플래그
DDENUMSURFACES_ALL
검색 조건을 충족하는 모든 표면을 열거합니다. 이 플래그는 DDENUMSURFACES_DOESEXIST 검색 유형 플래그에서만 사용할 수 있습니다.
DDENUMSURFACES_MATCH
표면 설명과 일치하는 표면을 검색합니다.
DDENUMSURFACES_NOMATCH
표면 설명과 일치하지 않는 표면을 검색합니다.
[in] unnamedParam2
관심 표면을 정의하는 DDSURFACEDESC2 구조체의 주소입니다. dwFlags에 DDENUMSURFACES_ALL 플래그가 포함된 경우 이 매개 변수는 NULL일 수 있습니다.
[in] unnamedParam3
각 열거형 멤버에 전달할 애플리케이션 정의 구조체의 주소입니다.
[in] unnamedParam4
일치 항목이 발견 될 때마다 열거형 프로시저가 호출하는 EnumSurfacesCallback7 함수의 주소입니다.
반환 값
메서드가 성공하면 반환 값이 DD_OK.
실패하면 메서드는 다음 오류 값 중 하나를 반환할 수 있습니다.
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
설명
DDENUMSURFACES_CANBECREATED 플래그가 설정된 경우 이 메서드는 검색 조건을 충족하는 표면을 일시적으로 만들려고 시도합니다.
DDENUMSURFACES_DOESEXIST 플래그를 사용하면 열거형 표면의 참조 수가 증가합니다. 표면을 사용하지 않을 경우 IDirectDrawSurface7::Release 를 사용하여 각 열거 후 해제해야 합니다. 표면을 사용하는 경우 더 이상 필요하지 않을 때 놓습니다.
이 메서드는 EnumSurfacesCallback 또는 EnumSurfacesCallback2 함수가 아닌 EnumSurfacesCallback7 함수에 대한 포인터를 허용한다는 점에서 이전 인터페이스 버전의 해당 메서드와 다릅니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | ddraw.h |
| 라이브러리 | Ddraw.lib |
| DLL | Ddraw.dll |