DXGKDDI_SETCONTEXTSCHEDULINGPROPERTIES Rückruffunktion (d3dkmddi.h)

Artikel
02/23/2024

Einrichten oder Ändern der Planungseigenschaften für einen Gerätekontext.

Syntax

DXGKDDI_SETCONTEXTSCHEDULINGPROPERTIES DxgkddiSetcontextschedulingproperties;

NTSTATUS DxgkddiSetcontextschedulingproperties(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_SETCONTEXTSCHEDULINGPROPERTIES pSetContextSchedulingProperties
)
{...}

Parameter

hAdapter

Ein Handle für den Gerätekontext.

pSetContextSchedulingProperties

Zeiger auf eine DXGKARG_SETCONTEXTSCHEDULINGPROPERTIES-Struktur , die die Planungseigenschaften enthält.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Geben Sie andernfalls einen geeigneten NTSTATUS-Werte-Fehlercode zurück.

Hinweise

Registrieren Sie Ihre Implementierung dieser Rückruffunktion, indem Sie den entsprechenden Member von DXGKARG_SETCONTEXTSCHEDULINGPROPERTIES festlegen und dann DxgkDdiSetContextSchedulingProperties aufrufen.

Wenn ein Adapter zum ersten Mal für einen bestimmten Prozess geöffnet wird, ruft das Betriebssystem DxgkDdiCreateProcess auf, damit der Kernelmodustreiber (KMD) eine geeignete Datennachverfolgungsstruktur pro Prozess und pro Adapter erstellen kann. Wenn ein Kontext erstellt wird, weiß der KMD, für welches Gerät und für welchen Adapter er erstellt wurde, und er sollte in der Lage sein, das KMD-Prozesshandle in der Nachverfolgungsdatenstruktur des Adapters für diesen Prozess nachzuschlagen. Innerhalb des KMD-Prozesses wird erwartet, dass der Planer über Nachverfolgungsdatenstrukturen für alle vier potenziellen Prioritätsbandkontexte verfügt, denen zugewiesen werden soll.

Wenn ein Kontext erstellt wird oder ein Direct3D-Gerät die Priorität ändert oder eine Anwendung den Fokus gewinnt oder verliert, ruft das Betriebssystem den GPU-Scheduler auf, um seine Planungseigenschaften einzurichten oder zu ändern. Für neu erstellte Kontexte garantiert das Betriebssystem, dass Kontextplanungseigenschaften festgelegt werden, bevor die erste Übermittlung an diesen Kontext zulässig ist. Dieser Aufruf kann in der Mitte einer Kontextausführung erfolgen. Der GPU-Scheduler hat einen gewissen Spielraum hinsichtlich der Auswirkungen auf den aktuellen Planungszeitraum, und die Betriebssystemanforderung besteht darin, dass die Änderung auf die nächste Planungsiteration für das Prioritätsband wirksam werden sollte.

Anforderungen

Anforderung	Wert
Header	d3dkmddi.h

Freigeben über