DXGKDDI_RELEASESWIZZLINGRANGE Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die DxgkDdiReleaseSwizzlingRange--Funktion gibt einen swizzling-Bereich frei, den die DxgkDdiAcquireSwizzlingRange Funktion zuvor eingerichtet hat.

Syntax

DXGKDDI_RELEASESWIZZLINGRANGE DxgkddiReleaseswizzlingrange;

NTSTATUS DxgkddiReleaseswizzlingrange(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_RELEASESWIZZLINGRANGE pReleaseSwizzlingRange
)
{...}

Parameter

[in] hAdapter

Ein Handle zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Der Display-Miniporttreiber, der zuvor dieses Handle für das Microsoft DirectX-Grafikkernsubsystem im MiniportDeviceContext Ausgabeparameter des DxgkDdiAddDevice--Funktion bereitgestellt hat.

[in] pReleaseSwizzlingRange

Ein Zeiger auf eine DXGKARG_RELEASESWIZZLINGRANGE Struktur, die Informationen zum Freigeben des Schwarmbereichs enthält.

Rückgabewert

DxgkDdiReleaseSwizzlingRange gibt STATUS_SUCCESS zurück oder ein entsprechendes Fehlerergebnis, wenn der Schwarmbereich nicht erfolgreich freigegeben wurde.

Bemerkungen

Die DxgkDdiReleaseSwizzlingRange Funktion wird in der Regel aufgerufen, wenn die angegebene Zuordnung (d. r. das Element der DXGKARG_RELEASESWIZZLINGRANGE Struktur, auf das das pReleaseSwizzlingRange Parameter verweist) entfernt oder zerstört wird, oder wenn eine andere Zuordnung den Schwarmbereich erfordert, den das RangeId Mitglied von DXGKARG_RELEASESWIZZLINGRANGE angibt.

Wenn die angegebene Zuordnung derzeit mehreren Swizzlingbereichen zugeordnet ist (durch Aufrufe an die DxgkDdiAcquireSwizzlingRange Funktion), sollte der Anzeigeminiporttreiber nur den Swizzlingbereich freigeben, den der RangeId Member von DXGKARG_RELEASESWIZZLINGRANGE angibt. Wenn der Anzeige-Miniporttreiber alle mit der Zuordnung verbundenen Swizzling-Bereiche freigibt, kann eine zufällige Beschädigung in der Zuordnung dazu führen, da eine Anwendung derzeit einen oder mehrere der Schwarmbereiche verwendet.

Der Treiber muss speicherzuordnungsfähige E/A (MMIO) verwenden, um einen Schwarmbereich einzurichten. Diese Schwarmbereichszugriffe dürfen die Ausführung der GPU nicht beeinträchtigen (d. a. die GPU darf nicht im Leerlauf sein, wenn DxgkDdiReleaseSwizzlingRange aufgerufen wird).

Alle Aufrufe von DxgkDdiReleaseSwizzlingRange werden untereinander serialisiert, jedoch nicht mit einer anderen DDI-Funktion (Device Driver Interface).

DxgkDdiReleaseSwizzlingRange sollte seitenfähig gemacht werden.