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 |