DXGKDDI_QUERYADAPTERINFO 콜백 함수(d3dkmddi.h)

  • 아티클

DxgkDdiQueryAdapterInfo 함수는 그래픽 어댑터에서 구성 정보를 검색합니다.

구문

DXGKDDI_QUERYADAPTERINFO DxgkddiQueryadapterinfo;

NTSTATUS DxgkddiQueryadapterinfo(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_QUERYADAPTERINFO pQueryAdapterInfo
)
{...}

매개 변수

[in] hAdapter

디스플레이 어댑터와 연결된 컨텍스트 블록에 대한 핸들입니다. 디스플레이 미니포트 드라이버는 이전에 DxgkDdiAddDevice 함수의 MiniportDeviceContext 출력 매개 변수에서 Microsoft DirectX 그래픽 커널 하위 시스템에 이 핸들을 제공했습니다.

[in] pQueryAdapterInfo

디스플레이 미니포트 드라이버가 그래픽 어댑터에 대한 구성 정보로 채우는 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 멤버에서 사용자 모드 표시 드라이버가 어댑터를 식별하는 데 필요한 구성 정보로 채워지는 독점 버퍼를 받습니다.

DirectX 그래픽 커널 하위 시스템(Dxgkrnl.sys일부)이 하위 시스템이 DxgkDdiQueryAdapterInfo를 호출할 때 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

추가 정보

DXGKARG_QUERYADAPTERINFO

DxgkDdiAddDevice

pfnQueryAdapterInfoCb