Condividi tramite


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)

Vedere anche

AllocateAdapterChannel

DMA_ADAPTER

DMA_OPERATIONS

FlushAdapterBuffers

FreeMapRegisters

IoGetDmaAdapter

MapTransfer