DXGKDDI_QUERY_CHILD_STATUS回调函数 (dispmprt.h)

项目
05/23/2024

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->Type 等于 StatusRotation，请在 ChildStatus->Rotation.Angle 中返回 (，) 连接到由 ChildStatus->ChildUid 标识的子设备的显示器的旋转角度。

DxgkDdiQueryChildStatus 应可分页。