DXGKDDI_QUERY_CHILD_RELATIONS回调函数 (dispmprt.h)

项目
05/23/2024

DxgkDdiQueryChildRelations 函数枚举显示适配器的子设备。

语法

DXGKDDI_QUERY_CHILD_RELATIONS DxgkddiQueryChildRelations;

NTSTATUS DxgkddiQueryChildRelations(
  [in]      IN_CONST_PVOID MiniportDeviceContext,
  [in, out] PDXGK_CHILD_DESCRIPTOR ChildRelations,
  [in]      ULONG ChildRelationsSize
)
{...}

参数

[in] MiniportDeviceContext

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

[in, out] ChildRelations

指向调用方分配和归零的 DXGK_CHILD_DESCRIPTOR 结构的数组的指针。数组中的元素数比 NumberOfChildren 参数中 DxgkDdiStartDevice 返回的值多一个。 DxgkDdiQueryChildRelations 必须使用描述显示适配器的子设备的信息填充数组中除最后一个结构的所有结构。数组中的最后一个结构必须保持为零。

[in] ChildRelationsSize

ChildRelations 数组的总大小（以字节为单位），包括末尾的归零结构。

返回值

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

注解

显示适配器的所有子设备都已载入;连接到显示适配器的监视器和其他外部设备不被视为子设备。

显示微型端口驱动程序必须填充DXGK_CHILD_DESCRIPTOR结构的数组，每个显示适配器的子级对应一个结构。数组必须包含所有当前子设备和所有潜在子设备的DXGK_CHILD_DESCRIPTOR结构。例如，如果停靠便携式计算机将导致新的视频输出变为可用，则这些视频输出在数组中必须具有描述符，即使它们当前不可用。

应使 DxgkDdiQueryChildRelations 函数可分页。