DXGKDDI_QUERY_INTERFACE callback function (dispmprt.h)

The DxgkDdiQueryInterface function returns a functional interface that is implemented by the display miniport driver.

Syntax

DXGKDDI_QUERY_INTERFACE DxgkddiQueryInterface;

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

Parameters

[in] MiniportDeviceContext

A handle to a context block associated with a display adapter. The display miniport driver's DxgkDdiAddDevice function previously provided this handle to the Microsoft DirectX graphics kernel subsystem.

[in] QueryInterface

A pointer to a QUERY_INTERFACE structure in which the display miniport driver should return information about the interface it supports.

Return value

DxgkDdiQueryInterface returns STATUS_SUCCESS if it succeeds; otherwise, it returns one of the error codes defined in Ntstatus.h. If a display miniport driver does not support the requested interface, it must return STATUS_NOT_SUPPORTED. By returning STATUS_NOT_SUPPORTED, the display miniport driver informs the operating system to pass the query on to the next driver.

Remarks

DxgkDdiQueryInterface exposes a communication mechanism between the display miniport driver and the driver of a child device (for example, a video capture device). A display miniport driver that exposes such a mechanism should implement this function.

DxgkDdiQueryInterface should fill in the members of the INTERFACE structure that QueryInterface->Interface points to as follows:

• Set Size to the number of bytes in the INTERFACE structure. This value must not exceed the number of bytes specified by QueryInterface->Size.
• Set Version to the version of the interface being returned by the display miniport driver. The display miniport driver should best match the version requested by the child driver in QueryInterface->Version.
• Set Context to point to a display miniport driver-defined context for the interface. Typically, a display miniport driver would set Context to the handle to the display adapter's context block that is identified by MiniportDeviceContext.
• Initialize InterfaceReference and InterfaceDereference to point to the display miniport driver-implemented reference and dereference routines for this interface.
• Initialize all additional interface-specific members to point to the appropriate routines of the interface being exposed.

Requirements

See also

DxgkDdiAddDevice

DxgkDdiQueryChildRelations

QUERY_INTERFACE