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 结构的成员，如下所示：

  • 将 “大小 ”设置为 INTERFACE 结构中的字节数。 此值不得超过 QueryInterface->Size 指定的字节数。
  • 将 “版本 ”设置为显示微型端口驱动程序返回的接口的版本。 显示微型端口驱动程序应与 QueryInterface->版本中的子驱动程序请求的版本最匹配。
  • 将 “上下文 ”设置为指向接口的显示微型端口驱动程序定义的上下文。 通常，显示微型端口驱动程序会将 Context 设置为由 MiniportDeviceContext 标识的显示适配器上下文块的句柄。
  • 初始化 InterfaceReference 和 InterfaceDereference 以指向此接口的显示微型端口驱动程序实现的引用和取消引用例程。
  • 初始化所有其他特定于接口的成员，以指向要公开的接口的相应例程。
DxgkDdiQueryInterface 在 IRQL = PASSIVE_LEVEL运行，应可分页。

要求

要求 值
最低受支持的客户端 在 Windows Vista 和更高版本的 Windows 操作系统中可用。
目标平台 桌面
标头 dispmprt.h
IRQL PASSIVE_LEVEL

另请参阅

DxgkDdiAddDevice

DxgkDdiQueryChildRelations

QUERY_INTERFACE