DXGKDDI_QUERY_INTERFACE回调函数 (dispmprt.h)

项目
05/23/2024

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 应填充 QueryInterface-Interface> 指向的 INTERFACE 结构的成员，如下所示：

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