DXGKDDI_QUERYADAPTERINFO 콜백 함수(d3dkmddi.h)
디스플레이 미니포트(KMD)의 DxgkDdiQueryAdapterInfo 함수는 그래픽 어댑터에서 구성 정보를 검색합니다.
구문
DXGKDDI_QUERYADAPTERINFO DxgkddiQueryadapterinfo;
NTSTATUS DxgkddiQueryadapterinfo(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_QUERYADAPTERINFO pQueryAdapterInfo
)
{...}
매개 변수
[in] hAdapter
디스플레이 어댑터와 연결된 컨텍스트 블록에 대한 핸들입니다. KMD는 이전에 DxgkDdiAddDevice 함수의 MiniportDeviceContext 출력 매개 변수에서 Dxgkrnl에 이 핸들을 제공했습니다.
[in] pQueryAdapterInfo
KMD가 그래픽 어댑터의 구성 정보로 채우는 DXGKARG_QUERYADAPTERINFO 구조체에 대한 포인터입니다.
반환 값
DxgkDdiQueryAdapterInfo 는 다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| STATUS_SUCCESS | DxgkDdiQueryAdapterInfo가 구성 정보를 성공적으로 검색했습니다. |
| STATUS_INVALID_PARAMETER | DxgkDdiQueryAdapterInfo에 전달된 매개 변수에는 완료되지 않는 오류가 포함되어 있습니다. |
| STATUS_NO_MEMORY | DxgkDdiQueryAdapterInfo가 완료하는 데 필요한 메모리를 할당할 수 없습니다. |
| STATUS_GRAPHICS_DRIVER_MISMATCH | 디스플레이 미니포트 드라이버는 DxgkDdiQueryAdapterInfo 호출을 시작한 사용자 모드 디스플레이 드라이버(즉, 디스플레이 미니포트 드라이버에 쿼리에 대한 프라이빗 데이터를 제공)와 호환되지 않습니다. |
설명
사용자 모드 표시 드라이버가 pfnQueryAdapterInfoCb 함수를 호출하면 DxgkDdiQueryAdapterInfo 함수에 대한 호출이 시작됩니다.
DxgkDdiQueryAdapterInfo가 pQueryAdapterInfo 매개 변수가 가리키는 DXGKARG_QUERYADAPTERINFO 구조체의 Type 멤버에서 DXGKQAITYPE_UMDRIVERPRIVATE 값을 받으면 pOutputData는 KMD가 사용자 모드 표시 드라이버가 어댑터를 식별하는 데 필요한 구성 정보로 채우는 독점 구조를 가리킵니다.
하위 시스템이 DxgkDdiQueryAdapterInfo를 호출할 때 Dxgkrnl이 DXGKARG_QUERYADAPTERINFO Type 멤버의 DXGKQAITYPE_DRIVERCAPS 값을 지정하는 경우 디스플레이 미니포트 드라이버는 제공된 DXGK_DRIVERCAPS 구조를 하위 시스템이 사용할 수 있는 정보로 채워야 합니다.
DirectX 그래픽 커널 하위 시스템이 DXGKARG_QUERYADAPTERINFO Type 멤버에 DXGKQAITYPE_QUERYSEGMENT 값을 제공하는 경우 디스플레이 미니포트 드라이버는 지원하는 메모리 세그먼트에 대한 정보를 제공해야 합니다. 메모리 세그먼트에 대한 자세한 내용은 메모리 세그먼트 사용 초기화를 참조하세요.
DxgkDdiQueryAdapterInfo 를 페이징 가능으로 만들어야 합니다.
WDDM 2.6 이상 을 지원하는 모든 드라이버는 DxgkDdiQueryAdapterInfo 콜백을 구현해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |