DXGKDDI_QUERY_CHILD_RELATIONS回调函数 (dispmprt.h)

  • 项目

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 结构的数组的指针。 数组中的元素数比 DxgkDdiStartDevice 在 NumberOfChildren 参数中返回的值多 1。 DxgkDdiQueryChildRelations 必须使用描述显示适配器的子设备的信息填充数组中除最后一个结构之外的所有结构。 数组中的最后一个结构必须保持为零。

[in] ChildRelationsSize

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

返回值

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

注解

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

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

应使 DxgkDdiQueryChildRelations 函数可分页。

要求

要求 值
最低受支持的客户端 在 Windows Vista 和更高版本的 Windows 操作系统中可用。
目标平台 桌面
标头 dispmprt.h
IRQL PASSIVE_LEVEL

另请参阅

DXGK_CHILD_DESCRIPTOR

DXGK_CHILD_STATUS

DxgkDdiQueryChildStatus

DxgkDdiQueryDeviceDescriptor