PFREE_ADAPTER_CHANNEL funzione di callback (wdm.h)

Articolo
08/08/2023

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)