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 函数以前提供了此句柄来 Dxgkrnl

[in] QueryInterface

指向 QUERY_INTERFACE 结构的指针,显示微型端口驱动程序应返回其支持的接口的相关信息。

返回值

DxgkDdiQueryInterface 如果成功,则返回STATUS_SUCCESS;否则,它将返回适当的 NTSTATUS 代码。 如果显示微型端口驱动程序不支持请求的接口,则必须返回STATUS_NOT_SUPPORTED。 通过返回STATUS_NOT_SUPPORTED,显示微型端口驱动程序会通知作系统将查询传递到下一个驱动程序。

言论

DxgkDdiQueryInterface 公开显示微型端口驱动程序与子设备的驱动程序(例如视频捕获设备)之间的通信机制。 公开此类机制的显示微型端口驱动程序应实现此函数。

DxgkDdiQueryInterface 应填写 INTERFACE 结构的成员,该结构 QueryInterface->接口 如下所示:

  • 大小 设置为 INTERFACE 结构中的字节数。 此值不能超过 QueryInterface指定的字节数 ->大小

  • 版本 设置为显示微型端口驱动程序返回的接口版本。 显示微型端口驱动程序应最符合 QueryInterface->版本中子驱动程序请求的版本。

  • 上下文 设置为指向接口的显示微型端口驱动程序定义的上下文。 通常,显示微型端口驱动程序会将 上下文 设置为由 MiniportDeviceContext标识的显示适配器的上下文块的句柄。

  • 初始化 InterfaceReferenceInterfaceDereference,以指向此接口的显示微型端口驱动程序实现的引用和取消引用例程。

  • 初始化所有其他特定于接口的成员,以指向要公开的接口的相应例程。

DxgkDdiQueryInterface 在 IRQL = PASSIVE_LEVEL 运行,并且应该可进行分页。

要求

要求 价值
最低支持的客户端 Windows Vista
目标平台 桌面
标头 dispmprt.h
IRQL PASSIVE_LEVEL

另请参阅

DxgkDdiAddDevice

DxgkDdiQueryChildRelations

QUERY_INTERFACE