DXGKDDI_QUERY_INTERFACE - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// dispmprt.h
DXGKDDI_QUERY_INTERFACE DxgkddiQueryInterface;
NTSTATUS DxgkddiQueryInterface(
[in] IN_CONST_PVOID MiniportDeviceContext,
[in] IN_PQUERY_INTERFACE QueryInterface
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
The DxgkDdiQueryInterface function returns a functional interface that is implemented by the display miniport driver.
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 Dxgkrnl.
QueryInterface [in]A pointer to a QUERY_INTERFACE structure in which the display miniport driver should return information about the interface it supports.
DxgkDdiQueryInterface returns STATUS_SUCCESS if it succeeds; otherwise, it returns an appropriate NTSTATUS code. If a display miniport driver doesn't 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.
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.