共用方式為

DXGKDDI_QUERY_CHILD_STATUS回呼函式 （dispmprt.h）

  • 發行項

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 HpdAwarenessPolled 或 HpdAwarenessInterruptible的子系，顯示埠驅動程式會呼叫 DxgkDdiQueryChildStatus，以判斷子系目前是否有硬體（例如監視器）連線。

DxgkDdiQueryChildStatus 必須執行下列動作：

  • 如果 ChildStatus->Type 等於 StatusConnection，則傳回 ChildStatus->HotPlug.Connected 中的布爾值。 如果 ChildStatus->ChildUid 所識別的子裝置已連線到其外部硬體，則 傳回 true;否則會傳回 FALSE 。
  • 如果 ChildStatus->Type 等於 StatusRotation，則會傳回 [ChildStatus->Rotation.Angle] 顯示連接到 ChildStatus->ChildUid 所識別子裝置的旋轉角度。
DxgkDdiQueryChildStatus 應設為可分頁。

要求

要求 價值
最低支援的用戶端 Windows Vista
目標平臺 桌面
標頭 dispmprt.h
IRQL PASSIVE_LEVEL

另請參閱

DXGK_CHILD_STATUS

DXGK_CHILD_STATUS_TYPE

DxgkDdiQueryChildRelations