DXGK_QUERYADAPTERINFOTYPE 열거형(d3dkmddi.h)
DXGK_QUERYADAPTERINFOTYPE 열거형은 커널 모드 KMD(디스플레이 미니포트 드라이버)가 DxgkDdiQueryAdapterInfo 함수가 호출될 때 pOutputData가 가리키는 버퍼에서 반환해야 하는 정보의 유형을 나타냅니다. 입력이 필요한 형식에 대한 자세한 내용은 DXGKARG_QUERYADAPTERINFO (pInputData)를 참조하세요.
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 = 36,
DXGKQAITYPE_NATIVE_FENCE_CAPS = 37,
DXGKQAITYPE_USERMODESUBMISSION_CAPS = 38,
DXGKQAITYPE_DIRTYBITTRACKINGCAPS = 39,
DXGKQAITYPE_DIRTYBITTRACKINGSEGMENTCAPS = 40,
DXGKQAITYPE_SCATTER_RESERVE = 41,
DXGKQAITYPE_QUERYPAGINGBUFFERINFO,
DXGKQAITYPE_QUERYSEGMENTCOUNT,
DXGKQAITYPE_QUERYSEGMENT5,
DXGKQAITYPE_QUERYMMUCOUNT,
DXGKQAITYPE_QUERYMMUS,
DXGKQAITYPE_64BITONLYCAPS,
DXGKQAITYPE_PAGINGPROCESSGPUVASIZE
} DXGK_QUERYADAPTERINFOTYPE;
상수
DXGKQAITYPE_UMDRIVERPRIVATE값: 0 디스플레이 드라이버에 대한 전용 전용 정의 데이터 구조를 나타냅니다. |
DXGKQAITYPE_DRIVERCAPS값: 1 KMD는 드라이버 기능으로 DXGK_DRIVERCAPS 구조를 채워야 합니다. |
DXGKQAITYPE_QUERYSEGMENT값: 2 KMD는 메모리 세그먼트 정보로 DXGK_QUERYSEGMENTOUT 구조를 채워야 합니다. |
DXGKQAITYPE_RESERVED값: 3 시스템에서 사용하도록 예약되었습니다. 드라이버에서 를 사용하지 마세요. 이 상수는 Windows 7부터 발생합니다. |
DXGKQAITYPE_QUERYSEGMENT2값: 4 시스템에서 사용하도록 예약되었습니다. 드라이버에서 를 사용하지 마세요. 이 상수는 Windows 7부터 발생합니다. |
DXGKQAITYPE_QUERYSEGMENT3값: 5 KMD는 메모리 세그먼트 정보로 DXGK_QUERYSEGMENTOUT3 구조를 채워야 합니다. Windows 8 부터 지원합니다. |
DXGKQAITYPE_NUMPOWERCOMPONENTS값: 6 디스플레이 미니포트는 사용하는 전원 구성 요소의 수를 지정하는 UINT 값을 제공해야 합니다. Windows 8 부터 지원합니다. |
DXGKQAITYPE_POWERCOMPONENTINFO값: 7 KMD는 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 KMD는 사용하는 기록 버퍼 데이터의 정밀도에 대한 정보로 DXGKARG_HISTORYBUFFERPRECISION 구조를 채워야 합니다. Windows 8.1 부터 지원합니다. |
DXGKQAITYPE_QUERYSEGMENT4값: 11 KMD는 메모리 세그먼트 정보를 나타내기 위해 DXGK_QUERYSEGMENTOUT4 구조를 채워야 합니다. Windows 10 부터 지원합니다. |
DXGKQAITYPE_SEGMENTMEMORYSTATE값: 12 KMD는 잘못된 메모리 범위로 DXGK_MEMORYRANGE 구조를 채워야 합니다. Windows 10 부터 지원합니다. |
DXGKQAITYPE_GPUMMUCAPS값: 13 KMD는 가상 메모리 관리 기능으로 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 KMD는 전원 전환 중에 시스템 메모리에 저장할 프레임 버퍼의 크기로 DXGK_FRAMEBUFFERSAVEAREA 구조를 채워야 합니다. Windows 10 버전 1803부터 지원됩니다. |
DXGKQAITYPE_HARDWARERESERVEDRANGES값: 22 KMD는 하드웨어 예약 메모리 범위로 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 KMD는 어댑터에서 엔진당 수집된 성능 데이터를 간격별로 나타내는 DXGK_NODE_PERFDATA 구조를 채워야 합니다. Windows 10 버전 1803부터 지원됩니다. |
DXGKQAITYPE_ADAPTERPERFDATA값: 25 KMD는 어댑터별로 수집된 성능 데이터를 간격별로 나타내는 DXGK_ADAPTER_PERFDATA 구조를 채워야 합니다. Windows 10 버전 1803부터 지원됩니다. |
DXGKQAITYPE_ADAPTERPERFDATA_CAPS값: 26 KMD는 초기화 중에 GPU당 한 번씩 정적이고 쿼리되는 데이터 기능을 나타내는 DXGK_ADAPTER_PERFDATACAPS 구조를 채워야 합니다. Windows 10 버전 1803부터 지원됩니다. |
DXGKQAITYPE_GPUVERSION값: 27 KMD는 GPU 초기화 중에 BIOS 버전 및 GPU 아키텍처 이름을 한 번 수집하는 데 사용되는 DXGK_GPUVERSION 구조를 채워야 합니다. Windows 10 버전 1803부터 지원됩니다. |
DXGKQAITYPE_DEVICE_TYPE_CAPS값: 28 KMD는 디바이스의 기능 유형을 설명하는 DXGK_DEVICE_TYPE_CAPS 구조를 채워야 합니다. Windows 10, 버전 1809 부터 지원합니다. |
DXGKQAITYPE_WDDMDEVICECAPS값: 29 KMD는 디바이스 초기화 중에 OS에서 쿼리하는 WDDM 기능이 포함된 DXGK_WDDMDEVICECAPS 구조를 채워야 합니다. Windows 10 버전 1903부터 지원됩니다. |
DXGKQAITYPE_GPUPCAPS값: 30 KMD는 커널 모드 디스플레이 드라이버에 대한 GPU 기능을 포함하는 DXGK_GPUPCAPS 구조를 채워야 합니다. Windows 10 버전 1903부터 지원됩니다. |
DXGKQAITYPE_QUERYTARGETGAMMACAPS값: 31 KMD는 KMD의 감마 기능을 설명하는 DXGK_TARGET_GAMMA_CAPS 구조를 채워야 합니다. Windows 10 버전 1903부터 지원됩니다. |
DXGKQAITYPE_SCANOUT_CAPS값: 33 KMD는 드라이버의 스캔 아웃 기능을 설명하는 DXGK_QUERY_SCANOUT_CAPS_OUT 구조를 채워야 합니다. Windows 10 버전 1903부터 지원됩니다. |
DXGKQAITYPE_PHYSICAL_MEMORY_CAPS값: 34 KMD는 디바이스의 실제 메모리 제한(가장 높은 표시 물리적 주소)을 설명하는 DXGK_PHYSICAL_MEMORY_CAPS 구조를 채워야 합니다. Windows Server 2022(WDDM 2.9)부터 지원됩니다. IOMMU 선형 다시 매핑에 대한 드라이버 지원을 나타내는 방법에 대한 자세한 내용은 DXGKQAITYPE_IOMMU_CAPS 참조하세요. |
DXGKQAITYPE_IOMMU_CAPS값: 35 KMD는 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 를 호출하여 디바이스를 시작합니다. |
DXGKQAITYPE_HARDWARERESERVEDRANGES2값: 36 |
DXGKQAITYPE_NATIVE_FENCE_CAPS값: 37 KMD는 네이티브 GPU 펜스에 대한 드라이버의 지원 세부 정보가 포함된 DXGK_NATIVE_FENCE_CAPS 구조를 채워야 합니다. Windows 11 버전 24H2부터 지원됩니다. 자세한 내용은 네이티브 GPU 펜스를 참조하세요. |
DXGKQAITYPE_USERMODESUBMISSION_CAPS값: 38 KMD는 사용자 모드 작업 제출에 대한 드라이버의 지원 세부 정보가 포함된 DXGK_USERMODESUBMISSION_CAPS 구조를 채워야 합니다. Windows 11 버전 24H2부터 지원됩니다. 자세한 내용은 사용자 모드 작업 제출을 참조하세요. |
DXGKQAITYPE_DIRTYBITTRACKINGCAPS값: 39 KMD는 더티 비트 추적에 대한 드라이버의 지원 세부 정보가 포함된 DXGK_DIRTY_BIT_TRACKING_CAPS 구조를 채워야 합니다. Windows 11 버전 24H2부터 지원됩니다. 자세한 내용은 더티 비트 추적을 참조하세요. |
DXGKQAITYPE_DIRTYBITTRACKINGSEGMENTCAPS값: 40 KMD는 특정 메모리 세그먼트에서 더티 비트 추적에 대한 드라이버의 지원 세부 정보가 포함된 DXGK_DIRTY_BIT_TRACKING_SEGMENT_CAPS 구조를 채워야 합니다. Windows 11 버전 24H2부터 지원됩니다. 자세한 내용은 더티 비트 추적을 참조하세요. |
DXGKQAITYPE_SCATTER_RESERVE값: 41 KMD는 분산 예약에 대한 드라이버의 지원 세부 정보가 포함된 DXGK_QUERYSCATTERRESERVEOUT 구조를 채워야 합니다. Windows 11 버전 24H2부터 지원됩니다. 자세한 내용은 GPU-P 디바이스에서 실시간 마이그레이션을 참조하세요. |
설명
Dxgkrnl 은 KMD의 DxgkDdiQueryAdapterInfo 콜백을 호출하여 그래픽 어댑터에서 구성 정보를 검색합니다. 드라이버는 DXGKARG_QUERYADAPTERINFO 구조체의 pOutputData 멤버가 가리키는 버퍼에서 요청된 정보를 채웁니다. 채울 구조체의 형식은 각 열거형 값을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 머리글 | d3dkmddi.h(D3dkmddi.h 포함) |