DXGKDDI_DESTROYALLOCATION Rückruffunktion (d3dkmddi.h)

Die DxgkDdiDestroyAllocation-Funktion veröffentlicht Zuordnungen.

Syntax

DXGKDDI_DESTROYALLOCATION DxgkddiDestroyallocation;

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

Parameter

[in] hAdapter

Ein Handle zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Der Display-Miniport-Treiber, der zuvor dieses Handle für das Microsoft DirectX-Grafik-Kernel-Subsystem im MiniportDeviceContext-Ausgabeparameter der DxgkDdiAddDevice-Funktion bereitgestellt hat.

[in] pDestroyAllocation

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

Rückgabewert

DxgkDdiDestroyAllocation gibt STATUS_SUCCESS zurück, oder ein entsprechendes Fehlerergebnis, wenn die Zuordnungen nicht erfolgreich veröffentlicht werden.

Bemerkungen

Wenn der Anzeigetreiber des Benutzermodus die Funktion pfnDeallocateCb aufruft, ruft das DirectX-Grafik-Kernel-Subsystem (das Teil von Dxgkrnl.sysist) die Display miniport-Treiber-Funktion DxgkDdiDestroyAllocation auf, um die Zuordnungen zu freigeben. Der Display-Miniporttreiber sollte seine internen Datenstrukturen und Verweise auf die Zuordnungen bereinigen. Die Microsoft Direct3D-Laufzeit initiiert Aufrufe an den Videospeicher-Manager (der auch Teil von Dxgkrnl.sysist), der dann den GPU-Zeitplan (was auch Teil von Dxgkrnl.sys) aufruft, um zu synchronisieren, bevor der Videospeicher tatsächlich veröffentlicht wird.

Der Display-Miniporttreiber kann die gesamte Ressource sowie Zuordnungen freigeben. Um zu ermitteln, ob die Ressource freigegeben werden soll, kann der Anzeige-Miniporttreiber überprüfen, ob das DestroyResource-Flag im Element " Flags " der DXGKARG_DESTROYALLOCATION-Struktur festgelegt ist, auf die der pDestroyAllocation-Parameter verweist. Um die Ressource zu freigeben, muss der Anzeige-Miniporttreiber den Handle bereinigen, den das hResource-Element von DXGKARG_DESTROYALLOCATION angibt. Wenn der Display-Miniporttreiber die Ressource nicht veröffentlicht, kann der Treiber den Wert in hResource ändern, falls erforderlich.

DxgkDdiDestroyAllocation sollte seitenfähig gemacht werden.

Anforderungen

   
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und späteren Versionen der Windows-Betriebssysteme.
Zielplattform Power BI Desktop
Header d3dkmddi.h
IRQL PASSIVE_LEVEL

Weitere Informationen

DXGKARG_DESTROYALLOCATION

DxgkDdiAddDevice

pfnDeallocateCb