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标识的显示适配器的上下文块的句柄。
初始化 InterfaceReference 和 InterfaceDereference,以指向此接口的显示微型端口驱动程序实现的引用和取消引用例程。
初始化所有其他特定于接口的成员,以指向要公开的接口的相应例程。
DxgkDdiQueryInterface 在 IRQL = PASSIVE_LEVEL 运行,并且应该可进行分页。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows Vista |
目标平台 | 桌面 |
标头 | dispmprt.h |
IRQL | PASSIVE_LEVEL |