通过

DXGKDDI_QUERY_CHILD_STATUS回调函数 （dispmprt.h）

  • 项目

DxgkDdiQueryChildStatus 函数返回显示适配器的单个子设备的状态。

语法

DXGKDDI_QUERY_CHILD_STATUS DxgkddiQueryChildStatus;

NTSTATUS DxgkddiQueryChildStatus(
  [in]      IN_CONST_PVOID MiniportDeviceContext,
  [in, out] INOUT_PDXGK_CHILD_STATUS ChildStatus,
  [in]      IN_BOOLEAN NonDestructiveOnly
)
{...}

参数

[in] MiniportDeviceContext

与显示适配器关联的上下文块的句柄。 显示微型端口驱动程序的 DxgkDdiAddDevice 函数以前向 DirectX 图形内核子系统提供了此句柄。

[in, out] ChildStatus

指向 DXGK_CHILD_STATUS 结构的指针。 调用方提供 ChildStatus->Type 和 ChildStatus->ChildUid。 返回时，剩余结构成员（联合）将收到请求的状态。

[in] NonDestructiveOnly

一个 BOOLEAN 值，该值指定是否允许显示微型端口驱动程序以导致视觉项目的方式确定请求的状态。 如果调用方将此参数设置为 TRUE，则不允许显示微型端口驱动程序导致项目。 如果调用方将此参数设置为 FALSE，则允许显示微型端口驱动程序导致项目。

返回值

DxgkDdiQueryChildStatus 如果成功，则返回STATUS_SUCCESS;否则，它将返回 Ntstatus.h中定义的错误代码之一。

言论

在初始化期间，显示端口驱动程序调用 DxgkDdiQueryChildRelations 以获取 MiniportDeviceContext表示的显示适配器子级的设备列表。 然后，对于每个具有 HPD 感知值的 HpdAwarenessPolled 或 HpdAwarenessInterruptible，显示端口驱动程序调用 DxgkDdiQueryChildStatus 来确定子级当前是否具有连接到它的硬件（例如监视器）。

DxgkDdiQueryChildStatus 必须执行以下作：

  • 如果 ChildStatus->Type 等于 StatusConnection，则返回 ChildStatus->HotPlug.Connected 中的布尔值。 如果 ChildStatus->ChildUid 标识的子设备已连接到子设备，则返回 TRUE;否则返回 FALSE。
  • 如果 ChildStatus->类型等于 StatusRotation，则返回（在 ChildStatus->Rotation.Angle 中）连接到 ChildStatus->ChildUid 标识的子设备的旋转角度。
应 DxgkDdiQueryChildStatus 进行分页。

要求

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

另请参阅

DXGK_CHILD_STATUS

DXGK_CHILD_STATUS_TYPE

DxgkDdiQueryChildRelations