DXGKDDI_GET_CHILD_CONTAINER_ID回呼函式 (dispmprt.h)

發行項
02/25/2024

查詢指定目標的容器標識碼。由 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 結構的指標。如需詳細資訊，請參閱＜備註＞一節。

傳回值

傳回下列其中一個錯誤碼。

傳回碼	Description
STATUS_SUCCESS	驅動程式已使用從顯示硬體取得的容器標識符資訊，更新 ContainerId 參數所指向的結構。
STATUS_MONITOR_NODESCRIPTOR	驅動程式已接受 ContainerId 所指向結構中提供的預設容器標識碼資訊。注意：如果驅動程式傳回此狀態代碼，則不應該修改結構。

否則函式會傳回 Ntstatus.h 中定義的其中一個狀態代碼。

備註

操作系統會呼叫 display miniport 驅動程式的 DxgkDdiQueryChildRelations 函式來列舉顯示適配卡的子裝置。然後，操作系統會呼叫每個子裝置的 display miniport 驅動程式 DxgkDdiQueryDeviceDescriptor 函式，以取得裝置的擴充顯示資訊數據 (EDID) 。如需此程式的詳細資訊，請參閱列舉顯示配接器的子裝置。

根據裝置的 EDID 數據，操作系統會產生子裝置的預設容器標識碼。然後，操作系統會呼叫display miniport驅動程式的 DxgkDdiGetChildContainerId 函式，並透過 ContainerId 參數傳遞DXGK_CHILD_CONTAINER_ID結構的指標。這個結構的 ContainerId 成員包含子顯示裝置的預設容器標識碼。

顯示迷你埠驅動程式可以接受預設容器標識碼，或將 ContainerId 成員設定為裝置的唯一標識符，再從呼叫 DxgkDdiGetChildContainerId。

如需容器標識碼的詳細資訊，請參閱容器標識碼。