DXGKDDI_DESTROYALLOCATION Rückruffunktion (d3dkmddi.h)

Artikel
02/23/2024

Die DxgkDdiDestroyAllocation-Funktion gibt Zuordnungen frei.

Syntax

DXGKDDI_DESTROYALLOCATION DxgkddiDestroyallocation;

NTSTATUS DxgkddiDestroyallocation(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_DESTROYALLOCATION pDestroyAllocation
)
{...}

Parameter

[in] hAdapter

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

[in] pDestroyAllocation

Ein Zeiger auf eine DXGKARG_DESTROYALLOCATION Struktur, die Informationen zum Freigeben von Zuordnungen enthält.

Rückgabewert

DxgkDdiDestroyAllocation gibt STATUS_SUCCESS oder ein entsprechendes Fehlerergebnis zurück, wenn die Zuordnungen nicht erfolgreich freigegeben wurden.

Hinweise

Wenn der Benutzermodusanzeigetreiber die Funktion pfnDeallocateCb aufruft , ruft das DirectX-Grafikkernsubsystem (das Teil vonDxgkrnl.sysist) die DxgkDdiDestroyAllocation-Funktion des Anzeigeminiporttreibers auf, um die Zuordnungen freizugeben. Der Anzeigeminiporttreiber sollte seine internen Datenstrukturen und Verweise auf die Zuordnungen sauber. Die Microsoft Direct3D-Runtime initiiert Aufrufe des Videospeicher-Managers (der ebenfalls Teil vonDxgkrnl.sysist), der dann den GPU-Scheduler aufruft (der ebenfalls Teil vonDxgkrnl.sysist), um zu synchronisieren, bevor der Videospeicher tatsächlich freigegeben wird.

Der Display-Miniporttreiber kann sowohl die gesamte Ressource als auch Zuordnungen freigeben. Um zu bestimmen, ob die Ressource freigegeben werden soll, kann der Anzeigeminiporttreiber überprüfen, ob das DestroyResource-Flag im Flags-Element der DXGKARG_DESTROYALLOCATION-Struktur festgelegt ist, auf die der pDestroyAllocation-Parameter verweist. Zum Freigeben der Ressource muss der Anzeigeminiporttreiber das Handle sauber, das der hResource-Member von DXGKARG_DESTROYALLOCATION angibt. Wenn der Anzeigeminiporttreiber die Ressource nicht freigibt, kann der Treiber den Wert bei Bedarf in hResource ändern.

DxgkDdiDestroyAllocation sollte seitenfähig gemacht werden.