DXGKDDI_QUERY_CHILD_STATUS回呼函式 (dispmprt.h)

發行項
05/23/2024

DxgkDdiQueryChildStatus 函式會傳回顯示適配卡之個別子裝置的狀態。

語法

DXGKDDI_QUERY_CHILD_STATUS DxgkddiQueryChildStatus;

NTSTATUS DxgkddiQueryChildStatus(
  [in]      IN_CONST_PVOID MiniportDeviceContext,
  [in, out] INOUT_PDXGK_CHILD_STATUS ChildStatus,
  [in]      IN_BOOLEAN NonDestructiveOnly
)
{...}

參數

[in] MiniportDeviceContext

與顯示配接器相關聯的內容區塊句柄。顯示迷你埠驅動程式的 DxgkDdiAddDevice 函式先前已將此句柄提供給 DirectX 圖形核心子系統。

[in, out] ChildStatus

DXGK_CHILD_STATUS 結構的指標。呼叫端會提供 ChildStatus-Type> 和 ChildStatus-ChildUid>。傳回時，剩餘的結構成員 (聯集) 會收到要求的狀態。

[in] NonDestructiveOnly

BOOLEAN 值，指定是否允許顯示迷你埠驅動程式以造成視覺成品的方式判斷要求的狀態。如果呼叫端將此參數設定為 TRUE，則不允許顯示迷你埠驅動程式造成成品。如果呼叫端將此參數設定為 FALSE，則允許顯示迷你埠驅動程式造成成品。

傳回值

DxgkDdiQueryChildStatus 如果成功，則會傳回STATUS_SUCCESS;否則，它會傳回 Ntstatus.h 中定義的其中一個錯誤碼。

備註

在初始化期間，顯示埠驅動程式會呼叫 DxgkDdiQueryChildRelations ，以取得 MiniportDeviceContext 所代表顯示適配卡子系的裝置清單。然後，針對具有 HpdAwarenessPolled 或 HpdAwarenessInterruptible 之 HPD 感知值的子系，顯示埠驅動程式會呼叫 DxgkDdiQueryChildStatus 來判斷子系目前是否具有硬體 (，例如監視) 與其連線。

DxgkDdiQueryChildStatus 必須執行下列動作：

如果 ChildStatus->Type 等於 StatusConnection，請在 ChildStatus->HotPlug.Connected 中傳回布爾值。如果 ChildStatus->ChildUid 所識別的子裝置已連接外部硬體，則傳回 TRUE ;否則傳回 FALSE。
如果 ChildStatus->Type 等於 StatusRotation，請在 ChildStatus->Rotation.Angle 中傳回 () 連接到 ChildStatus->ChildUid 所識別之子裝置的旋轉角度。

DxgkDdiQueryChildStatus 應設為可分頁。