Expand Minimize

DxgkDdiQueryInterface routine

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

Syntax


PDXGKDDI_QUERY_INTERFACE DxgkDdiQueryInterface;

NTSTATUS DxgkDdiQueryInterface(
  _In_  const PVOID MiniportDeviceContext,
  _In_  PQUERY_INTERFACE QueryInterface
)
{ ... }

Parameters

MiniportDeviceContext [in]

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.

QueryInterface [in]

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.

DxgkDdiQueryInterface runs at IRQL = PASSIVE_LEVEL and should be made pageable.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

Dispmprt.h (include Dispmprt.h)

IRQL

PASSIVE_LEVEL

See also

QUERY_INTERFACE
DxgkDdiAddDevice
DxgkDdiQueryChildRelations

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft