DXGKDDI_QUERY_CHILD_STATUS Rückruffunktion (dispmprt.h)

Artikel
05/23/2024

Die DxgkDdiQueryChildStatus-Funktion gibt die status eines einzelnen untergeordneten Geräts eines Grafikkartes 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 für einen Kontextblock, der einer Grafikkarte zugeordnet ist. Die DxgkDdiAddDevice-Funktion des Display-Miniporttreibers hat dieses Handle zuvor für das DirectX-Grafikkernsubsystem bereitgestellt.

[in, out] ChildStatus

Ein Zeiger auf eine DXGK_CHILD_STATUS-Struktur . Der Aufrufer liefert ChildStatus-Type> und ChildStatus-ChildUid>. Bei der Rückgabe empfängt das verbleibende Strukturelement (eine Union) die angeforderte status.

[in] NonDestructiveOnly

Ein BOOLEAN-Wert, der angibt, ob der Anzeigeminiporttreiber die angeforderte status auf eine Weise bestimmen darf, die visuelle Artefakte verursacht. Wenn der Aufrufer diesen Parameter auf TRUE festlegt, darf der Anzeige-Miniporttreiber keine Artefakte verursachen. Wenn der Aufrufer diesen Parameter auf FALSE festlegt, darf der Anzeige-Miniporttreiber Artefakte verursachen.

Rückgabewert

DxgkDdiQueryChildStatus gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird einer der in "Ntstatus.h" definierten Fehlercodes zurückgegeben.

Hinweise

Während der Initialisierung ruft der Anzeigeporttreiber DxgkDdiQueryChildRelations auf, um eine Liste der Geräte abzurufen, die untergeordnete Elemente des durch MiniportDeviceContext dargestellten Anzeigeadapters sind. Anschließend ruft der Anzeigeporttreiber für jedes Untergeordnete, das über den HPD-Sensibilisierungswert HpdAwarenessPolled oder HpdAwarenessInterruptible verfügt, DxgkDdiQueryChildStatus auf, um zu bestimmen, ob für das Kind derzeit Hardware (z. B. ein Monitor) verbunden ist.

DxgkDdiQueryChildStatus muss die folgenden Aktionen ausführen:

Wenn ChildStatus->Type gleich StatusConnection ist, geben Sie einen booleschen Wert in ChildStatus->HotPlug.Connected zurück. Gibt TRUE zurück, wenn für das untergeordnete Gerät, das von ChildStatus->ChildUid identifiziert wird, externe Hardware angeschlossen ist. gibt andernfalls FALSE zurück.
Wenn ChildStatus->Type gleich StatusRotation ist, geben Sie (in ChildStatus->Rotation.Angle) den Drehwinkel für die Anzeige zurück, die mit dem durch ChildStatus->ChildUid identifizierten untergeordneten Gerät verbunden ist.

DxgkDdiQueryChildStatus sollte als ausgelagert werden.