DXGKDDI_GET_CHILD_CONTAINER_ID回呼函式 （dispmprt.h）
查詢指定目標的容器標識碼。 由 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 | 驅動程式已使用從顯示硬體取得的容器標識符資訊，更新 ContainerId 參數所指向的結構。 |
| STATUS_MONITOR_NODESCRIPTOR | 驅動程式已接受 ContainerId 所指向結構中提供的預設容器標識碼資訊。 注意： 如果驅動程式傳回此狀態代碼，則不應該修改 結構。 |
否則，函式會傳回 Ntstatus.h 中定義的其中一個狀態代碼。
言論
作系統會呼叫 display miniport 驅動程式的 DxgkDdiQueryChildRelations 函式來列舉顯示適配卡的子裝置。 作系統接著會呼叫顯示迷你埠驅動程式的 DxgkDdiQueryDeviceDescriptor 函式，讓每個子裝置取得裝置的擴充顯示信息數據 （EDID）。 如需此程式的詳細資訊，請參閱 列舉顯示配接器子裝置。
根據裝置的 EDID 數據，作系統會產生子裝置的預設容器標識碼。 然後，作系統會呼叫display miniport驅動程式的 DxgkDdiGetChildContainerId 函式，並透過 ContainerId 參數傳遞 DXGK_CHILD_CONTAINER_ID 結構的指標。 這個結構 ContainerId 成員包含子顯示裝置的預設容器識別碼。
顯示迷你連接埠驅動程式可以接受預設容器識別碼，或將 ContainerId 成員設定為裝置的唯一識別碼，然後再從呼叫 dxgkDdiGetChildContainerId 傳回 。
如需容器識別碼的詳細資訊，請參閱 容器識別碼。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 8 |
| 支援的最低伺服器 | Windows Server 2012 |
| 目標平臺 | 桌面 |
| 標頭 | dispmprt.h |
| IRQL | PASSIVE_LEVEL |