DXGK_QUERYADAPTERINFOTYPE 열거형(d3dkmddi.h)

  • 아티클

DXGK_QUERYADAPTERINFOTYPE 열거형은 디스플레이 미니포트 드라이버의 DxgkDdiQueryAdapterInfo 함수가 호출되는 경우 검색할 정보 유형을 나타냅니다.

Syntax

typedef enum _DXGK_QUERYADAPTERINFOTYPE {
  DXGKQAITYPE_UMDRIVERPRIVATE = 0,
  DXGKQAITYPE_DRIVERCAPS = 1,
  DXGKQAITYPE_QUERYSEGMENT = 2,
  DXGKQAITYPE_RESERVED = 3,
  DXGKQAITYPE_QUERYSEGMENT2 = 4,
  DXGKQAITYPE_QUERYSEGMENT3 = 5,
  DXGKQAITYPE_NUMPOWERCOMPONENTS = 6,
  DXGKQAITYPE_POWERCOMPONENTINFO = 7,
  DXGKQAITYPE_PREFERREDGPUNODE = 8,
  DXGKQAITYPE_POWERCOMPONENTPSTATEINFO = 9,
  DXGKQAITYPE_HISTORYBUFFERPRECISION = 10,
  DXGKQAITYPE_QUERYSEGMENT4 = 11,
  DXGKQAITYPE_SEGMENTMEMORYSTATE = 12,
  DXGKQAITYPE_GPUMMUCAPS = 13,
  DXGKQAITYPE_PAGETABLELEVELDESC = 14,
  DXGKQAITYPE_PHYSICALADAPTERCAPS = 15,
  DXGKQAITYPE_DISPLAY_DRIVERCAPS_EXTENSION = 16,
  DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR = 17,
  DXGKQAITYPE_UEFIFRAMEBUFFERRANGES = 18,
  DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES = 19,
  DXGKQAITYPE_DISPLAYID_DESCRIPTOR = 20,
  DXGKQAITYPE_FRAMEBUFFERSAVESIZE = 21,
  DXGKQAITYPE_HARDWARERESERVEDRANGES = 22,
  DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR2 = 23,
  DXGKQAITYPE_NODEPERFDATA = 24,
  DXGKQAITYPE_ADAPTERPERFDATA = 25,
  DXGKQAITYPE_ADAPTERPERFDATA_CAPS = 26,
  DXGKQAITYPE_GPUVERSION = 27,
  DXGKQAITYPE_DEVICE_TYPE_CAPS = 28,
  DXGKQAITYPE_WDDMDEVICECAPS = 29,
  DXGKQAITYPE_GPUPCAPS = 30,
  DXGKQAITYPE_QUERYTARGETGAMMACAPS = 31,
  DXGKQAITYPE_SCANOUT_CAPS = 33,
  DXGKQAITYPE_PHYSICAL_MEMORY_CAPS = 34,
  DXGKQAITYPE_IOMMU_CAPS = 35,
  DXGKQAITYPE_HARDWARERESERVEDRANGES2,
  DXGKQAITYPE_NATIVE_FENCE_CAPS,
  DXGKQAITYPE_USERMODESUBMISSION_CAPS
} DXGK_QUERYADAPTERINFOTYPE;

상수

 
DXGKQAITYPE_UMDRIVERPRIVATE
값: 0
디스플레이 드라이버에 대한 전용 전용 정의 데이터 구조를 나타냅니다.
DXGKQAITYPE_DRIVERCAPS
값: 1
디스플레이 미니포트 드라이버는 DXGK_DRIVERCAPS 구조를 드라이버 기능으로 채워야 합니다.
DXGKQAITYPE_QUERYSEGMENT
값: 2
디스플레이 미니포트 드라이버는 메모리 세그먼트 정보로 DXGK_QUERYSEGMENTOUT 구조를 채워야 합니다.
DXGKQAITYPE_RESERVED
값: 3
시스템에서 사용하도록 예약되었습니다. 드라이버에서 를 사용하지 마세요. 이 상수는 Windows 7부터 발생합니다.
DXGKQAITYPE_QUERYSEGMENT2
값: 4
시스템에서 사용하도록 예약되었습니다. 드라이버에서 를 사용하지 마세요. 이 상수는 Windows 7부터 발생합니다.
DXGKQAITYPE_QUERYSEGMENT3
값: 5
디스플레이 미니포트 드라이버는 메모리 세그먼트 정보로 DXGK_QUERYSEGMENTOUT3 구조를 채워야 합니다. Windows 8 부터 지원합니다.
DXGKQAITYPE_NUMPOWERCOMPONENTS
값: 6
디스플레이 미니포트는 사용하는 전원 구성 요소의 수를 지정하는 UINT 값을 제공해야 합니다. Windows 8 부터 지원합니다.
DXGKQAITYPE_POWERCOMPONENTINFO
값: 7
디스플레이 미니포트 드라이버는 n번째 전원 구성 요소에 대한 정보로 DXGK_POWER_RUNTIME_COMPONENT 구조를 채워야 합니다.여기서 n은 DxgkDdiQueryAdapterInfo 호출에서 DXGKARG_QUERYADAPTERINFO.pInputData에 의해 지정된 구성 요소 인덱스입니다. Windows 8 부터 지원합니다.
DXGKQAITYPE_PREFERREDGPUNODE
값: 8
시스템에서 사용하도록 예약되었습니다. 드라이버에서 를 사용하지 마세요. 이 상수는 Windows 8 시작됩니다.
DXGKQAITYPE_POWERCOMPONENTPSTATEINFO
값: 9
시스템에서 사용하도록 예약되었습니다. 드라이버에서 를 사용하지 마세요. Windows 8.1 부터 지원합니다.
DXGKQAITYPE_HISTORYBUFFERPRECISION
값: 10
디스플레이 미니포트 드라이버는 사용하는 기록 버퍼 데이터의 정밀도에 대한 정보로 DXGKARG_HISTORYBUFFERPRECISION 구조를 채워야 합니다. Windows 8.1 부터 지원합니다.
DXGKQAITYPE_QUERYSEGMENT4
값: 11
디스플레이 미니포트 드라이버는 메모리 세그먼트 정보를 나타내기 위해 DXGK_QUERYSEGMENTOUT4 구조를 채워야 합니다. Windows 10 부터 지원합니다.
DXGKQAITYPE_SEGMENTMEMORYSTATE
값: 12
디스플레이 미니포트 드라이버는 DXGK_MEMORYRANGE 구조를 잘못된 메모리 범위로 채워야 합니다. Windows 10 부터 지원합니다.
DXGKQAITYPE_GPUMMUCAPS
값: 13
디스플레이 미니포트 드라이버는 가상 메모리 관리 기능으로 DXGK_GPUMMUCAPS 구조를 채워야 합니다. Windows 10 부터 지원합니다.
DXGKQAITYPE_PAGETABLELEVELDESC
값: 14
시스템에서 사용하도록 예약되었습니다. 드라이버에서 를 사용하지 마세요. 이 상수는 Windows 10 시작됩니다.
DXGKQAITYPE_PHYSICALADAPTERCAPS
값: 15
시스템에서 사용하도록 예약되었습니다. 드라이버에서 를 사용하지 마세요. 이 상수는 Windows 10 시작됩니다.
DXGKQAITYPE_DISPLAY_DRIVERCAPS_EXTENSION
값: 16
시스템에서 사용하도록 예약되었습니다. 드라이버에서 를 사용하지 마세요. 이 상수는 Windows 10 시작됩니다.
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR
값: 17
Windows 10 버전 1703부터 지원됩니다. 쿼리에 대한 입력 버퍼가 DXGK_QUERYINTEGRATEDDISPLAYIN 구조이고 출력 버퍼가 DXGK_QUERYINTEGRATEDDISPLAYOUT구조인 통합 패널 설명자에 대한 요청을 나타냅니다.

이 함수는 대상을 처리하지만 자식 디바이스 잠금이 아닌 DxgKrnl 어댑터 잠금만 이 호출을 인수합니다. 실제로 자식 디바이스가 노출되기 전에 이 호출이 수행되므로 동일한 대상을 처리하는 동시 DDI 호출이 없어야 합니다.

참고: 대부분의 QueryAdapterInfo 호출과 달리 출력 버퍼 크기는 가변적이지만 대상 ID에 대한 DXGK_INTEGRATED_DISPLAY_CHILD 구조의 DescriptorLength 필드에서는 아직 미리 알려져 있습니다. 출력 버퍼의 크기는 다음과 같습니다.
DescriptorLength + FIELD_OFFSET( DXGK_QUERYINTEGRATEDDISPLAYOUT, Descriptor ).
DXGKQAITYPE_UEFIFRAMEBUFFERRANGES
값: 18
UEFI 프레임 버퍼 범위에 대한 요청을 나타냅니다. Windows 10 버전 1703부터 지원됩니다.
DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES
값: 19
Windows 10 버전 1703부터 지원됩니다. 쿼리에 대한 입력 버퍼가 주소 지정되는 대상 ID만 포함하는 DXGK_QUERYCOLORIMETRYOVERRIDESIN 구조이고 출력 버퍼는 드라이버가 대상에 연결된 모니터에 대한 재정의를 작성하는 DXGK_COLORIMETRY 구조인 외부 디스플레이에 대한 색 측정 재정의 요청을 나타냅니다.

이 함수는 대상을 처리하지만 자식 디바이스 잠금이 아닌 DxgKrnl 어댑터 잠금만 이 호출을 인수합니다. 이 호출은 자식 디바이스가 노출되기 전에 수행되므로 동일한 대상을 처리하는 동시 DDI 호출이 없어야 합니다.

드라이버에 전달되면 출력 버퍼가 0이 됩니다. 드라이버에 모니터에 대한 재정의가 없는 경우 STATUS_SUCCESS 반환하고 출력 버퍼를 0으로 유지해야 합니다. 드라이버에 재정의가 있는 경우 OS가 부분 재정의를 허용하지 않으므로 모니터 기능을 설명하기 위해 DXGK_COLORIMETRY 모든 필드를 채웁니다.
DXGKQAITYPE_DISPLAYID_DESCRIPTOR
값: 20
쿼리에 대한 입력 버퍼가 DXGK_QAITARGETIN 구조이고 출력 버퍼가 DXGK_QUERYINTEGRATEDDISPLAYOUT구조인 통합 패널 설명자에 대한 요청을 나타냅니다. Windows 10 버전 1709부터 지원됩니다.
DXGKQAITYPE_FRAMEBUFFERSAVESIZE
값: 21
디스플레이 미니포트 드라이버는 전원 전환 중에 시스템 메모리에 저장할 프레임 버퍼의 크기로 DXGK_FRAMEBUFFERSAVEAREA 구조를 채워야 합니다. Windows 10 버전 1803부터 지원됩니다.
DXGKQAITYPE_HARDWARERESERVEDRANGES
값: 22
디스플레이 미니포트 드라이버는 하드웨어 예약 메모리 범위로 DXGK_HARDWARERESERVEDRANGES 구조를 채워야 합니다. Windows 10 버전 1803부터 지원됩니다.
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR2
값: 23
Windows 10 버전 1803부터 지원됩니다. 쿼리에 대한 입력 버퍼가 DXGK_QAITARGETIN 구조이고 출력 버퍼가 DXGK_QUERYINTEGRATEDDISPLAYOUT2구조인 통합 패널 설명자에 대한 요청을 나타냅니다. 이 쿼리는 WDDM 2.4 드라이버에 대한 DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR 쿼리 사용을 대체합니다.

TypeIntegratedDisplay 자식 디바이스는 형식이 이 값으로 설정된 DxgkDdiQueryAdapterInfo를 호출하여 보고됩니다.
DXGKQAITYPE_NODEPERFDATA
값: 24
디스플레이 미니포트 드라이버는 어댑터에서 엔진당 수집된 성능 데이터를 간격별로 나타내는 DXGK_NODE_PERFDATA 구조를 채워야 합니다. Windows 10 버전 1803부터 지원됩니다.
DXGKQAITYPE_ADAPTERPERFDATA
값: 25
디스플레이 미니포트 드라이버는 어댑터별로 수집된 성능 데이터를 간격별로 나타내는 DXGK_ADAPTER_PERFDATA 구조를 채워야 합니다. Windows 10 버전 1803부터 지원됩니다.
DXGKQAITYPE_ADAPTERPERFDATA_CAPS
값: 26
디스플레이 미니포트 드라이버는 초기화 중에 GPU당 한 번씩 정적이고 쿼리되는 데이터 기능을 나타내는 DXGK_ADAPTER_PERFDATACAPS 구조를 채워야 합니다. Windows 10 버전 1803부터 지원됩니다.
DXGKQAITYPE_GPUVERSION
값: 27
디스플레이 미니포트 드라이버는 GPU 초기화 중에 BIOS 버전 및 GPU 아키텍처 이름을 한 번 수집하는 데 사용되는 DXGK_GPUVERSION 구조를 채워야 합니다. Windows 10 버전 1803부터 지원됩니다.
DXGKQAITYPE_DEVICE_TYPE_CAPS
값: 28
디스플레이 미니포트 드라이버는 디바이스의 기능 유형을 설명하는 DXGK_DEVICE_TYPE_CAPS 구조를 채워야 합니다. Windows 10, 버전 1809 시작 지원.
DXGKQAITYPE_WDDMDEVICECAPS
값: 29
디스플레이 미니포트 드라이버는 디바이스 초기화 중에 OS에서 쿼리하는 WDDM 기능이 포함된 DXGK_WDDMDEVICECAPS 구조를 채워야 합니다. Windows 10 버전 1903부터 지원됩니다.
DXGKQAITYPE_GPUPCAPS
값: 30
디스플레이 미니포트 드라이버는 커널 모드 표시 드라이버에 대한 GPU 기능이 포함된 DXGK_GPUPCAPS 구조를 채워야 합니다. Windows 10 버전 1903부터 지원됩니다.
DXGKQAITYPE_QUERYTARGETGAMMACAPS
값: 31
디스플레이 미니포트 드라이버는 디스플레이 미니포트 드라이버의 감마 기능을 설명하는 DXGK_TARGET_GAMMA_CAPS 구조를 채워야 합니다. Windows 10 버전 1903부터 지원됩니다.
DXGKQAITYPE_SCANOUT_CAPS
값: 33
디스플레이 미니포트 드라이버는 드라이버의 스캔아웃 기능을 설명하는 DXGK_QUERY_SCANOUT_CAPS_OUT 구조를 채워야 합니다. Windows 10 버전 1903부터 지원됩니다.
DXGKQAITYPE_PHYSICAL_MEMORY_CAPS
값: 34
디스플레이 미니포트 드라이버는 디바이스의 실제 메모리 제한(가장 눈에 띄는 실제 주소)을 설명하는 DXGK_PHYSICAL_MEMORY_CAPS 구조를 채워야 합니다. Windows Server 2022(WDDM 2.9)부터 지원됩니다.

IOMMU 선형 다시 매핑에 대한 드라이버 지원을 나타내는 방법에 대한 자세한 내용은 DXGKQAITYPE_IOMMU_CAPS 참조하세요.
DXGKQAITYPE_IOMMU_CAPS
값: 35
디스플레이 미니포트 드라이버는 IOMMU 선형 다시 매핑이 드라이버에서 지원됨을 나타내는 DXGK_IOMMU_CAPS 구조를 채워야 합니다. Windows Server 2022(WDDM 2.9)부터 지원됩니다. 선형 다시 매핑에 대한 지원을 나타내려면 드라이버는 DXGKQAITYPE_PHYSICAL_MEMORY_CAPS 한도를 통해 Dxgkernel에 실제 메모리 제한 사항을 알려야 합니다.

논리 다시 매핑은 디바이스에서 참조하는 기존 실제 메모리가 없는 경우에만 수행할 수 있으므로 Dxgkrnl의 호출 순서는 다음과 같습니다.

* 드라이버가 연결된 모든 물리적 어댑터에 대한 정보를 수집할 수 있도록 모든 물리적 어댑터에 대해 DxgkDdiAddDevice 를 호출합니다.

* 메모리에 액세스하기 전에 디바이스를 만들고 IOMMU 도메인에 연결할 수 있도록 DXGKQAITYPE_PHYSICAL_MEMORY_CAPS 및 DXGKQAITYPE_IOMMU_CAPS DxgkDdiQueryAdapterInfo 를 호출합니다.

* DxgkDdiStartDevice 를 호출하여 디바이스를 시작합니다.

설명

Dxgkrnl은 디스플레이 미니포트 드라이버의 DxgkDdiQueryAdapterInfo 콜백을 호출하여 그래픽 어댑터에서 구성 정보를 검색합니다. 드라이버는 DXGKARG_QUERYADAPTERINFO 구조체의 pOutputData 멤버가 가리키는 버퍼에서 요청된 정보를 채웁니다. 채울 구조체의 형식은 각 열거형 값을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista
머리글 d3dkmddi.h(D3dkmddi.h 포함)

추가 정보

DXGKARG_QUERYADAPTERINFO

DxgkDdiQueryAdapterInfo