DisplayConfigGetDeviceInfo 함수(winuser.h)

아티클
08/27/2023

DisplayConfigGetDeviceInfo 함수는 디바이스에 대한 표시 구성 정보를 검색합니다.

구문

LONG DisplayConfigGetDeviceInfo(
  [in, out] DISPLAYCONFIG_DEVICE_INFO_HEADER *requestPacket
);

매개 변수

[in, out] requestPacket

DISPLAYCONFIG_DEVICE_INFO_HEADER 구조체에 대한 포인터입니다. 이 구조체에는 형식 멤버의 패킷 형식을 포함하는 요청에 대한 정보가 포함됩니다. 헤더 구조가 패킷 형식에 따라 달라진 후 DisplayConfigGetDeviceInfo 가 반환하는 추가 데이터의 형식 및 크기입니다.

반환 값

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

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

설명

DisplayConfigGetDeviceInfo 함수를 사용하여 디스플레이 이름, 기본 설정 표시 모드 및 원본 디바이스 이름과 같은 어댑터의 원본 또는 대상에 대한 추가 정보를 가져옵니다.

호출자는 DisplayConfigGetDeviceInfo 를 호출하여 사용자 인터페이스에 표시할 보다 친숙한 이름을 가져올 수 있습니다. 호출자는 어댑터, 원본 및 대상의 이름을 가져올 수 있습니다. 호출자는 DisplayConfigGetDeviceInfo 를 호출하여 연결된 디스플레이 디바이스의 최상의 해상도를 얻을 수도 있습니다.

예제

DisplayConfigGetDeviceInfo의 예는 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에 도입됨)