Condividi tramite


DXGKDDI_DESTROYALLOCATION funzione di callback (d3dkmddi.h)

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 precedentemente fornito questo handle al sottosistema kernel della grafica Microsoft DirectX nel MiniportDeviceContext parametro di output della funzione DxgkDdiAddDevice.

[in] pDestroyAllocation

Puntatore a una struttura 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.

Osservazioni

Quando il driver di visualizzazione in modalità utente chiama la funzione pfnDeallocateCb, il sottosistema kernel grafico DirectX (che fa parte di Dxgkrnl.sys) chiama il driver miniport visualizzato dxgkDdiDestroyAllocation funzione per rilasciare le allocazioni. Il driver miniport di visualizzazione deve pulire le 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ò verificare se il flag destroyResource è impostato nel Flags membro 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 visualizzato non rilascia la risorsa, il driver può modificare il valore in hResource, se necessario.

il DxgkDdiDestroyAllocation deve essere reso pageable.

Fabbisogno

Requisito Valore
client minimo supportato Windows Vista
piattaforma di destinazione Desktop
intestazione d3dkmddi.h
IRQL PASSIVE_LEVEL

Vedere anche

DXGKARG_DESTROYALLOCATION

DxgkDdiAddDevice

pfnDeallocateCb