D3DKMTSetDisplayMode 함수(d3dkmthk.h)
D3DKMTSetDisplayMode 함수는 디스플레이로 검색하는 데 사용되는 할당을 설정합니다.
구문
NTSTATUS D3DKMTSetDisplayMode(
[in, out] const D3DKMT_SETDISPLAYMODE *unnamedParam1
);
매개 변수
[in, out] unnamedParam1
검색에 사용되는 할당을 설명하는 D3DKMT_SETDISPLAYMODE 구조체에 대한 포인터입니다.
반환 값
D3DKMTSetDisplayMode 는 다음 값 중 하나를 반환합니다.
반환 코드 | 설명 |
---|---|
STATUS_SUCCESS | 표시 모드가 성공적으로 설정되었습니다. |
STATUS_DEVICE_REMOVED | 그래픽 어댑터가 중지되었거나 디스플레이 디바이스가 다시 설정되었습니다. |
STATUS_INVALID_PARAMETER | 매개 변수의 유효성이 검사되었고 잘못된 것으로 확인되었습니다. |
STATUS_GRAPHICS_NOT_EXCLUSIVE_MODE_OWNER | D3DKMTSetDisplayMode를 호출하기 전에 디바이스는 보기의 배타적 소유권을 획득하지 못했습니다. 따라서 디바이스에서 디스플레이 모드를 설정할 수 없습니다. |
D3DDDIERR_INCOMPATIBLEPRIVATEFORMAT | ICD(OpenGL 설치 가능 클라이언트 드라이버)는 D3DKMT_SETDISPLAYMODE hPrimaryAllocation 멤버가 지정하는 할당과 연결된 표면의 형식을 D3DKMT_SETDISPLAYMODEPrivateDriverFormatAttribute 멤버 가 지정하는 형식 특성으로 변환해야 합니다. 그런 다음 ICD는 D3DKMTSetDisplayMode 를 다시 호출해야 합니다. ICD는 새 할당을 할당하고, 이전 주 데이터베이스에서 새 로의 변환 비트 블록 전송(비트블렛)을 수행한 다음, ICD가 모든 후속 작업에 이 할당에 새 할당 핸들을 사용하는 한 이전 주 데이터베이스를 삭제할 수 있습니다. ICD는 D3DKMTSetDisplayMode 가 다른 반환 값을 반환할 때까지 이 프로세스를 반복해야 합니다. |
이 함수는 다른 NTSTATUS 값을 반환할 수도 있습니다.
설명
OpenGL ICD가 D3DKMTSetDisplayMode 를 호출하여 확장된 형식, 다중 샘플링 방법 또는 둘 다를 사용하는 새 디스플레이 모드를 설정하기 전에 ICD는 현재 GDI 디스플레이 모드가 새 디스플레이 모드와 동일한 해상도를 갖도록 해야 합니다. 그렇지 않으면 D3DKMTSetDisplayMode 는 STATUS_INVALID_PARAMETER 반환합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista |
대상 플랫폼 | 유니버설 |
헤더 | d3dkmthk.h(D3dkmthk.h 포함) |
라이브러리 | Gdi32.lib |
DLL | Gdi32.dll |