PFREE_MAP_REGISTERS funzione di callback (wdm.h)

Articolo
02/29/2024

La routine FreeMapRegisters rilascia un set di registri mappa salvati da una chiamata a AllocateAdapterChannel.

Sintassi

PFREE_MAP_REGISTERS PfreeMapRegisters;

void PfreeMapRegisters(
  [in] PDMA_ADAPTER DmaAdapter,
  [in] PVOID MapRegisterBase,
  [in] ULONG NumberOfMapRegisters
)
{...}

Parametri

[in] DmaAdapter

Puntatore alla struttura DMA_ADAPTER restituita da IoGetDmaAdapter che rappresenta l'adattatore bus-master o il controller DMA.

[in] MapRegisterBase

Specifica i registri mappa allocati per l'operazione DMA. Il sistema passa questo valore alla routine AdapterControl del driver.

[in] NumberOfMapRegisters

Specifica il numero di registri mappa da rilasciare. Questo valore deve corrispondere al numero specificato in una chiamata precedente a AllocateAdapterChannel.

Valore restituito

nessuno

Osservazioni

FreeMapRegisters non è una routine di sistema che può essere chiamata direttamente in base al 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.

Quando il driver di un dispositivo master del bus ha completato la richiesta di trasferimento DMA basata su pacchetti corrente, chiama FreeMapRegisters per rilasciare i registri della mappa allocati in precedenza da una chiamata a AllocateAdapterChannel e conservati perché la routine AdapterControl ha restituito DeallocateObjectKeepRegisters. Il driver deve chiamare FreeMapRegisters dopo aver chiamato FlushAdapterBuffers.

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