Expand Minimize

DxgkDdiGetChildContainerId routine

Queries the container ID for the specified target. Implemented by Windows Display Driver Model (WDDM) 1.2 and later display miniport drivers.



_Check_return_ NTSTATUS* DxgkDdiGetChildContainerId(
  _In_    PVOID                    MiniportDeviceContext,
  _In_    ULONG                    ChildUid,
{ ... }


MiniportDeviceContext [in]

A handle to a context block that is associated with a display adapter. The display miniport driver's DxgkDdiAddDevice function previously provided this handle to the Microsoft DirectX graphics kernel subsystem.

ChildUid [in]

A ULONG value that uniquely identifies the child device. The display miniport driver previously provided this identifier when its DxgkDdiQueryChildRelations function was called.

ContainerId [in, out]

A pointer to a DXGK_CHILD_CONTAINER_ID structure. For more information, see the Remarks section.

Return value

Returns one of the following error codes.

Return codeDescription

The driver has updated the structure pointed to by the ContainerId parameter with container ID information obtained from the display hardware.


The driver has accepted the default container ID information provided in the structure pointed to by ContainerId.

Note  If the driver returns this status code, it should not modify the structure.


Otherwise the function returns one of the status codes defined in Ntstatus.h.


The operating system calls the display miniport driver's DxgkDdiQueryChildRelations function to enumerate the child devices of the display adapter. The operating system then calls the display miniport driver's DxgkDdiQueryDeviceDescriptor function for each child device to obtain the Extended Display Information Data (EDID) for the device. For more information on this procedure, see Enumerating Child Devices of a Display Adapter.

Based on the device's EDID data, the operating system generates a default container ID for the child device. Then, the operating system calls the display miniport driver's DxgkDdiGetChildContainerId function and passes a pointer to a DXGK_CHILD_CONTAINER_ID structure through the ContainerId parameter. The ContainerId member of this structure contains the default container ID for the child display device.

The display miniport driver can either accept the default container ID or set the ContainerId member to a unique identifier for the device before it returns from the call to DxgkDdiGetChildContainerId.

For more information about Container IDs, see Container IDs.


Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Target platform



Dispmprt.h (include Dispmprt.h)



See also




Send comments about this topic to Microsoft

© 2015 Microsoft