DXGKDDI_QUERY_CHILD_STATUS Rückruffunktion (dispmprt.h)

Artikel
02/06/2025

Die DxgkDdiQueryChildStatus Funktion gibt den Status eines einzelnen untergeordneten Geräts eines Anzeigeadapters zurück.

Syntax

DXGKDDI_QUERY_CHILD_STATUS DxgkddiQueryChildStatus;

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

Parameter

[in] MiniportDeviceContext

Ein Handle zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Die DxgkDdiAddDevice-Funktion des Display-Miniporttreibers stellt dieses Handle zuvor für das DirectX-Grafik-Kernel-Subsystem bereit.

[in, out] ChildStatus

Ein Zeiger auf eine DXGK_CHILD_STATUS Struktur. Der Aufrufer stellt "ChildStatus">"Type" und "ChildStatus">ChildUid bereit. Im Gegenzug erhält das verbleibende Strukturmitglied (eine Union) den angeforderten Status.

[in] NonDestructiveOnly

Ein BOOLESCHER Wert, der angibt, ob der Anzeigeminiporttreiber den angeforderten Status auf eine Weise bestimmen darf, die visuelle Artefakte verursacht. Wenn der Aufrufer diesen Parameter auf TRUEfestlegt, darf der Anzeige-Miniporttreiber keine Artefakte verursachen. Wenn der Aufrufer diesen Parameter auf FALSE-festlegt, darf der Anzeigeminiporttreiber Artefakte verursachen.

Rückgabewert

DxgkDdiQueryChildStatus-gibt STATUS_SUCCESS zurück, wenn dies erfolgreich ist; andernfalls wird eine der in Ntstatus.hdefinierten Fehlercodes zurückgegeben.

Bemerkungen

Während der Initialisierung ruft der Anzeigeporttreiber DxgkDdiQueryChildRelations- auf, um eine Liste der Geräte abzurufen, die untergeordnete Elemente des Anzeigeadapters sind, dargestellt durch MiniportDeviceContext. Anschließend ruft der Anzeigeporttreiber HpdAwarenessPolled oder HpdAwarenessInterruptibleden HpdAwareness-Bewusstseinswert DxgkDdiQueryChildStatus auf, um zu bestimmen, ob das Kind derzeit über Hardware (z. B. einen Monitor) verfügt.

DxgkDdiQueryChildStatus- müssen die folgenden Aktionen ausführen:

Wenn childStatus->Type gleich StatusConnectionist, geben Sie einen booleschen Wert in ChildStatus->HotPlug.Connected zurück. Gibt TRUE- zurück, wenn das untergeordnete Gerät, das von ChildStatus identifiziert wurde, über eine externe Hardware verbunden ist>ChildUid; andernfalls wird FALSE-zurückgegeben.
Wenn childStatus->Type gleich StatusRotationist, geben Sie (in ChildStatus->Rotation.Angle) den Drehwinkel für die Anzeige zurück, die mit dem untergeordneten Gerät verbunden ist, das durch ChildStatus->ChildUid identifiziert wird.

DxgkDdiQueryChildStatus sollte seitenfähig gemacht werden.