DXGKDDI_QUERY_INTERFACE 콜백 함수(dispmprt.h)

아티클
05/23/2024

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

구문

DXGKDDI_QUERY_INTERFACE DxgkddiQueryInterface;

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

매개 변수

[in] MiniportDeviceContext

디스플레이 어댑터와 연결된 컨텍스트 블록에 대한 핸들입니다. 디스플레이 미니포트 드라이버의 DxgkDdiAddDevice 함수는 이전에 이 핸들을 Dxgkrnl에 제공했습니다.

[in] QueryInterface

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

반환 값

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

설명

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

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

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