GetDisplayConfigBufferSizes 함수(winuser.h)
GetDisplayConfigBufferSizes 함수는 QueryDisplayConfig 함수를 호출하는 데 필요한 버퍼의 크기를 검색합니다.
구문
LONG GetDisplayConfigBufferSizes(
[in] UINT32 flags,
[out] UINT32 *numPathArrayElements,
[out] UINT32 *numModeInfoArrayElements
);
매개 변수
[in] flags
검색할 정보의 유형입니다. Flags 매개 변수의 값은 다음 값 중 하나여야 합니다.
QDC_ALL_PATHS
호출자는 가능한 모든 경로 조합을 보유하도록 테이블 크기를 요청합니다.
QDC_ONLY_ACTIVE_PATHS
호출자는 활성 경로만 보유하도록 테이블 크기를 요청합니다.
QDC_DATABASE_CURRENT
호출자는 현재 연결된 모니터의 지속성 데이터베이스에 정의된 활성 경로를 보유하도록 테이블 크기를 요청합니다.
[out] numPathArrayElements
경로 정보 테이블의 요소 수를 받는 변수에 대한 포인터입니다. pNumPathArrayElements 매개 변수 값은 QueryDisplayConfig 함수에 대한 후속 호출에서 사용됩니다. 이 매개 변수는 NULL일 수 없습니다.
[out] numModeInfoArrayElements
모드 정보 테이블의 요소 수를 받는 변수에 대한 포인터입니다. pNumModeInfoArrayElements 매개 변수 값은 QueryDisplayConfig 함수에 대한 후속 호출에서 사용됩니다. 이 매개 변수는 NULL일 수 없습니다.
반환 값
함수는 다음 반환 코드 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
함수가 성공했습니다. |
|
지정된 매개 변수와 플래그의 조합이 잘못되었습니다. |
|
시스템에서 WDDM(Windows 디스플레이 드라이버 모델)에 따라 작성된 그래픽 드라이버를 실행하고 있지 않습니다. 함수는 WDDM 드라이버가 실행되는 시스템에서만 지원됩니다. |
|
호출자는 콘솔 세션에 액세스할 수 없습니다. 이 오류는 호출 프로세스에서 현재 데스크톱에 액세스할 수 없거나 원격 세션에서 실행 중인 경우에 발생합니다. |
|
지정되지 않은 오류가 발생했습니다. |
설명
현재 표시 경로 구성 및 요청된 플래그를 감안할 때 GetDisplayConfigBufferSizes 는 정보를 저장하는 데 필요한 경로 및 모드 테이블의 크기를 반환합니다. GetDisplayConfigBufferSizes 는 모든 원본 및 대상 경로가 유효하다고 판단하기 때문에 실제로 필요한 것보다 약간 큰 값을 반환할 수 있습니다. 반면, 드라이버는 가능한 조합에 몇 가지 제한을 둘 수 있습니다.
GetDisplayConfigBufferSizes는 해당 시점의 필수 배열 크기만 확인할 수 있으므로 GetDisplayConfigBufferSizes와 QueryDisplayConfig 호출 사이에 시스템 구성이 변경되고 제공된 배열 크기가 더 이상 새 경로 데이터를 저장하기에 충분하지 않을 수 있습니다.
호출자가 추가 원본 및 대상을 사용하도록 설정해야 한다는 것을 알고 있는 경우 호출자는 GetDisplayConfigBufferSizes에서 반환된 것보다 더 큰 모드 정보 배열을 할당하여 QueryDisplayConfig를 호출한 후 SetDisplayConfig를 호출하기 전에 추가 원본 및 대상 모드를 추가할 수 있는 공간을 확보합니다.
예제
GetDisplayConfigBufferSizes의 예는 QueryDisplayConfig를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | winuser.h(Windows.h 포함) |
| 라이브러리 | User32.lib; Windows 10 OneCoreUAP.lib |
| DLL | User32.dll |
| API 세트 | ext-ms-win-ntuser-sysparams-ext-l1-1-1(Windows 10 버전 10.0.14393에 도입됨) |