DXGKDDI_GET_CHILD_CONTAINER_ID回调函数 (dispmprt.h)

项目
02/23/2024

查询指定目标的容器 ID。由 Windows 显示驱动程序模型 (WDDM) 1.2 及更高版本的显示微型端口驱动程序实现。

语法

DXGKDDI_GET_CHILD_CONTAINER_ID DxgkddiGetChildContainerId;

NTSTATUS DxgkddiGetChildContainerId(
  [in]      PVOID MiniportDeviceContext,
  [in]      ULONG ChildUid,
  [in, out] PDXGK_CHILD_CONTAINER_ID ContainerId
)
{...}

参数

[in] MiniportDeviceContext

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

[in] ChildUid

唯一标识子设备的 ULONG 值。显示微型端口驱动程序以前在调用其 DxgkDdiQueryChildRelations 函数时提供了此标识符。

[in, out] ContainerId

指向 DXGK_CHILD_CONTAINER_ID 结构的指针。有关详细信息，请参见“备注”部分。

返回值

返回以下错误代码之一。

返回代码	说明
STATUS_SUCCESS	驱动程序已使用从显示硬件获取的容器 ID 信息更新 ContainerId 参数指向的结构。
STATUS_MONITOR_NODESCRIPTOR	驱动程序已接受 ContainerId 指向的结构中提供的默认容器 ID 信息。注意：如果驱动程序返回此状态代码，则不应修改结构。

否则，函数将返回 Ntstatus.h 中定义的状态代码之一。

注解

操作系统调用显示微型端口驱动程序的 DxgkDdiQueryChildRelations 函数来枚举显示适配器的子设备。然后，操作系统为每个子设备调用显示微型端口驱动程序的 DxgkDdiQueryDeviceDescriptor 函数，以获取设备的扩展显示信息数据 (EDID) 。有关此过程的详细信息，请参阅枚举显示适配器的子设备。

操作系统根据设备的 EDID 数据为子设备生成默认容器 ID。然后，操作系统调用显示微型端口驱动程序的 DxgkDdiGetChildContainerId 函数，并通过 ContainerId 参数传递指向 DXGK_CHILD_CONTAINER_ID 结构的指针。此结构的 ContainerId 成员包含子显示设备的默认容器 ID。

显示微型端口驱动程序可以接受默认容器 ID，或者在从对 DxgkDdiGetChildContainerId 的调用返回之前，将 ContainerId 成员设置为设备的唯一标识符。

有关容器 ID 的详细信息，请参阅容器 ID。