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일 수 없습니다.

반환 값

함수는 다음 반환 코드 중 하나를 반환합니다.

반환 코드	설명
ERROR_SUCCESS	함수가 성공했습니다.
ERROR_INVALID_PARAMETER	지정된 매개 변수와 플래그의 조합이 잘못되었습니다.
ERROR_NOT_SUPPORTED	시스템에서 WDDM(Windows 디스플레이 드라이버 모델)에 따라 작성된 그래픽 드라이버를 실행하고 있지 않습니다. 함수는 WDDM 드라이버가 실행되는 시스템에서만 지원됩니다.
ERROR_ACCESS_DENIED	호출자는 콘솔 세션에 액세스할 수 없습니다. 이 오류는 호출 프로세스에서 현재 데스크톱에 액세스할 수 없거나 원격 세션에서 실행 중인 경우에 발생합니다.
ERROR_GEN_FAILURE	지정되지 않은 오류가 발생했습니다.

설명

현재 표시 경로 구성 및 요청된 플래그를 감안할 때 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에 도입됨)

추가 정보

QueryDisplayConfig

SetDisplayConfig