D3DKMTGetDisplayModeList 함수(d3dkmthk.h)
D3DKMTGetDisplayModeList 함수는 확장 형식의 모드를 포함하여 사용 가능한 표시 모드 목록을 검색합니다.
구문
NTSTATUS D3DKMTGetDisplayModeList(
D3DKMT_GETDISPLAYMODELIST *unnamedParam1
);
매개 변수
unnamedParam1
[in/out] pData 는 이 함수에 대한 인수를 포함하는 D3DKMT_GETDISPLAYMODELIST 구조체에 대한 포인터입니다.
반환 값
D3DKMTGetDisplayModeList 는 다음 중 하나와 같은 NTSTATUS 값을 반환합니다.
반환 코드 | 설명 |
---|---|
STATUS_SUCCESS | 사용 가능한 디스플레이 모드 목록이 성공적으로 검색되었거나 pData-pModeList가 NULL이고 pData-ModeCount>가 입력 시 0인 경우 pData-ModeCount>> 에서 표시 모드 수가 반환되었습니다. |
STATUS_DEVICE_REMOVED | 그래픽 어댑터가 중지되었습니다. |
STATUS_BUFFER_TOO_SMALL | 클라이언트 드라이버가 pData-pModeList>에 제공한 버퍼가 요청된 표시 모드 목록을 포함할 만큼 크지 않습니다. |
STATUS_GRAPHICS_NO_AVAILABLE_VIDPN_TARGET | pData-VidPnSourceId>로 식별되는 비디오 현재 원본과 함께 사용할 수 있는 비디오 프레젠테이션 대상은 없습니다. 따라서 이 원본에는 표시 모드를 사용할 수 없습니다. |
STATUS_INVALID_PARAMETER** | 매개 변수의 유효성이 검사되었고 잘못된 것으로 확인되었습니다. |
설명
그래픽 어댑터(pData-hAdapter)에서 지정된 VidPn 원본(pData-VidPnSourceId>)에 대한 표시 모드 수를 가져오기 위해 클라이언트 드라이버는 pData-pModeList>가 NULL로 설정되고 pData-ModeCount>> 가 0으로 설정된 D3DKMTGetDisplayModeList를 호출할 수 있습니다. 이 호출이 STATUS_SUCCESS 반환하는 경우 반환된 pData-ModeCount>는 표시 모드의 총 수입니다. 그런 다음 클라이언트 드라이버는 ModeCountD3DKMT_DISPLAYMODE 구조의 배열을 할당하고 , pModeList 를 이 배열을 가리키도록 설정하고, D3DKMTGetDisplayModeList 를 다시 호출하여 표시 모드 목록을 검색할 수 있습니다.
지정된 VidPn 원본의 표시 특성을 이러한 두 호출 간에 변경할 수 있으므로 표시 모드 목록이 변경됩니다. 이 경우 호출자가 제공한 D3DKMT_DISPLAYMODE 배열이 새 표시 모드 목록을 저장할 만큼 크지 않은 경우 이 함수는 반환된 ModeCount의 새 표시 모드 수와 함께 STATUS_BUFFER_TOO_SMALL 반환합니다. 호출자는 이전 D3DKMT_DISPLAYMODE 배열을 해제하고, 반환된 새 번호에 따라 새 D3DKMT_DISPLAYMODE 배열을 할당하고, 새 번호와 새 D3DKMT_DISPLAYMODE 배열을 사용하여 이 함수를 다시 호출하여 새 표시 모드 목록을 가져올 수 있습니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista |
대상 플랫폼 | 유니버설 |
헤더 | d3dkmthk.h(D3dkmthk.h 포함) |
라이브러리 | Gdi32.lib |
DLL | Gdi32.dll |
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기