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 |