DXGKDDI_QUERY_INTERFACE 콜백 함수(dispmprt.h)

  • 아티클

DxgkDdiQueryInterface 함수는 디스플레이 미니포트 드라이버에 의해 구현되는 기능 인터페이스를 반환합니다.

구문

DXGKDDI_QUERY_INTERFACE DxgkddiQueryInterface;

NTSTATUS DxgkddiQueryInterface(
  [in] IN_CONST_PVOID MiniportDeviceContext,
  [in] IN_PQUERY_INTERFACE QueryInterface
)
{...}

매개 변수

[in] MiniportDeviceContext

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

[in] QueryInterface

디스플레이 미니포트 드라이버가 지원하는 인터페이스에 대한 정보를 반환해야 하는 QUERY_INTERFACE 구조체에 대한 포인터입니다.

반환 값

DxgkDdiQueryInterface 는 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 Ntstatus.h에 정의된 오류 코드 중 하나를 반환합니다. 디스플레이 미니포트 드라이버가 요청된 인터페이스를 지원하지 않는 경우 STATUS_NOT_SUPPORTED 반환해야 합니다. STATUS_NOT_SUPPORTED 반환하면 디스플레이 미니포트 드라이버가 운영 체제에 쿼리를 다음 드라이버에 전달하도록 알릴 수 있습니다.

설명

DxgkDdiQueryInterface 는 디스플레이 미니포트 드라이버와 자식 디바이스의 드라이버(예: 비디오 캡처 디바이스) 간의 통신 메커니즘을 노출합니다. 이러한 메커니즘을 노출하는 디스플레이 미니포트 드라이버는 이 함수를 구현해야 합니다.

DxgkDdiQueryInterface는 QueryInterface-Interface>가 가리키는 INTERFACE 구조체의 멤버를 다음과 같이 채워야 합니다.

  • SIZE를 INTERFACE 구조의 바이트 수로 설정합니다. 이 값은 QueryInterface-> Size에 지정된 바이트 수를 초과해서는 안됩니다.
  • 버전을 디스플레이 미니포트 드라이버에서 반환되는 인터페이스 버전으로 설정합니다. 디스플레이 미니포트 드라이버는 QueryInterface-> 버전에서 자식 드라이버가 요청한버전과 가장 일치해야 합니다.
  • 인터페이스에 대한 디스플레이 미니포트 드라이버 정의 컨텍스트를 가리키도록 컨텍스트 를 설정합니다. 일반적으로 디스플레이 미니포트 드라이버는 MiniportDeviceContext로 식별되는 디스플레이 어댑터의 컨텍스트 블록에 대한 핸들로 컨텍스트를 설정합니다.
  • InterfaceReference 및 InterfaceDereference를 초기화하여 이 인터페이스에 대한 표시 미니포트 드라이버 구현 참조 및 역참조 루틴을 가리킵니다.
  • 노출되는 인터페이스의 적절한 루틴을 가리키도록 모든 추가 인터페이스별 멤버를 초기화합니다.
DxgkDdiQueryInterface는 IRQL = PASSIVE_LEVEL 실행되며 페이징 가능해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼 데스크톱
머리글 dispmprt.h
IRQL PASSIVE_LEVEL

추가 정보

DxgkDdiAddDevice

DxgkDdiQueryChildRelations

QUERY_INTERFACE