DXGKDDI_RELEASESWIZZLINGRANGE Rückruffunktion (d3dkmddi.h)

Artikel
02/27/2024

Die DxgkDdiReleaseSwizzlingRange-Funktion gibt einen Schwenkbereich 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 für einen Kontextblock, der einer Grafikkarte zugeordnet ist. Der Anzeige-Miniporttreiber hat dieses Handle zuvor für das Microsoft DirectX-Grafikkernsubsystem im Ausgabeparameter MiniportDeviceContext der DxgkDdiAddDevice-Funktion bereitgestellt.

[in] pReleaseSwizzlingRange

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

Rückgabewert

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

Hinweise

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

Wenn die angegebene Zuordnung derzeit mehreren Swizzlingbereichen zugeordnet ist (durch Aufrufe der DxgkDdiAcquireSwizzlingRange-Funktion ), sollte der Anzeige-Miniporttreiber nur den Swizzlingbereich freigeben, den das RangeId-Element von DXGKARG_RELEASESWIZZLINGRANGE angibt. Wenn der Anzeige-Miniporttreiber alle der Zuordnung zugeordneten Swizzlingbereiche freigibt, kann es zu zufälliger Beschädigung der Zuordnung kommen, da eine Anwendung derzeit möglicherweise einen oder mehrere der Swizzlingbereiche verwendet.

Der Treiber muss speicherseitig zugeordnete E/A (MMIO) verwenden, um einen Schwenkbereich einzurichten. Diese Swizzling-Range-Zugriffe dürfen die Ausführung der GPU nicht beeinträchtigen (d. h. die GPU darf sich nicht im Leerlauf befinden, wenn DxgkDdiReleaseSwizzlingRange aufgerufen wird).

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

DxgkDdiReleaseSwizzlingRange sollte ausgelagert werden.