PFREE_ADAPTER_CHANNEL funzione di callback (wdm.h)
La routine FreeAdapterChannel rilascia il controller DMA di sistema quando un driver ha completato tutte le operazioni DMA necessarie per soddisfare l'IRP corrente.
Sintassi
PFREE_ADAPTER_CHANNEL PfreeAdapterChannel;
void PfreeAdapterChannel(
[in] PDMA_ADAPTER DmaAdapter
)
{...}
Parametri
[in] DmaAdapter
Puntatore alla struttura DMA_ADAPTER restituita da IoGetDmaAdapter che rappresenta l'adattatore bus-master o il controller DMA.
Valore restituito
Nessuno
Osservazioni
FreeAdapterChannel non è una routine di sistema che può essere chiamata direttamente per nome. Questa routine è chiamabile solo dal puntatore dall'indirizzo restituito in una struttura DMA_OPERATIONS. I driver ottengono l'indirizzo di questa routine chiamando IoGetDmaAdapter.
Dopo che un driver ha trasferito tutti i dati e chiamato FlushAdapterBuffers, chiama FreeAdapterChannel per rilasciare il controller DMA di sistema allocato in precedenza con una chiamata a AllocateAdapterChannel.
FreeAdapterChannel libera tutti i registri mappa allocati da una chiamata precedente a AllocateAdapterChannel. Un driver chiama questa routine solo se la routine AdapterControl restituisce KeepObject.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows 2000. |
| piattaforma di destinazione | Desktop |
| intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | DISPATCH_LEVEL |
| regole di conformità DDI | IrqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm) |