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 结构的数组的指针。 数组中的元素数大于 NumberOfChildren 参数中 DxgkDdiStartDevice 返回的值。 DxgkDdiQueryChildRelations 必须填写数组中最后一个结构,其中包含描述显示适配器的子设备的信息。 数组中的最后一个结构必须保持零。

[in] ChildRelationsSize

ChildRelations 的总大小(以字节为单位) 数组,包括末尾的零结构。

返回值

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

言论

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

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

应将 DxgkDdiQueryChildRelations 函数设为可分页。

要求

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

另请参阅

DXGK_CHILD_DESCRIPTOR

DXGK_CHILD_STATUS

DxgkDdiQueryChildStatus

DxgkDdiQueryDeviceDescriptor