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 di 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 restituisceKeepObject.

Requisiti

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)

Vedi anche

AllocateAdapterChannel

DMA_ADAPTER

DMA_OPERATIONS

FlushAdapterBuffers

FreeMapRegisters

IoGetDmaAdapter

MapTransfer