DXGKDDI_DESTROYALLOCATION funzione di callback (d3dkmddi.h)

Articolo
02/23/2024

La funzione DxgkDdiDestroyAllocation rilascia le allocazioni.

Sintassi

DXGKDDI_DESTROYALLOCATION DxgkddiDestroyallocation;

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

Parametri

[in] hAdapter

Handle di un blocco di contesto associato a una scheda di visualizzazione. Il driver miniport di visualizzazione fornito in precedenza questo handle al sottosistema kernel della grafica Microsoft DirectX nel parametro di output MiniportDeviceContext della funzione DxgkDdiAddDevice .

[in] pDestroyAllocation

Puntatore a una struttura di DXGKARG_DESTROYALLOCATION che contiene informazioni per il rilascio delle allocazioni.

Valore restituito

DxgkDdiDestroyAllocation restituisce STATUS_SUCCESS o un risultato di errore appropriato se le allocazioni non vengono rilasciate correttamente.

Commenti

Quando il driver di visualizzazione in modalità utente chiama la funzione pfnDeallocateCb , il sottosistema kernel grafico DirectX (che fa parte di Dxgkrnl.sys) chiama la funzione DxgkDdiDestroyAllocation del driver miniport di visualizzazione per rilasciare le allocazioni. Il driver miniport di visualizzazione deve pulire le relative strutture di dati interne e i riferimenti alle allocazioni. Il runtime di Microsoft Direct3D avvia le chiamate alla gestione della memoria video (che fa anche parte di Dxgkrnl.sys), che chiama quindi l'utilità di pianificazione GPU (che fa anche parte di Dxgkrnl.sys) per la sincronizzazione prima del rilascio effettivo della memoria video.

Il driver miniport di visualizzazione può rilasciare l'intera risorsa e le allocazioni. Per determinare se la risorsa deve essere rilasciata, il driver miniport di visualizzazione può controllare se il flag DestroyResource è impostato nel membro Flags della struttura DXGKARG_DESTROYALLOCATION a cui punta il parametro pDestroyAllocation . Per rilasciare la risorsa, il driver miniport di visualizzazione deve pulire l'handle specificato dal membro hResource di DXGKARG_DESTROYALLOCATION. Se il driver miniport di visualizzazione non rilascia la risorsa, il driver può modificare il valore in hResource , se necessario.

DxgkDdiDestroyAllocation deve essere reso pageable.