PFREE_MAP_REGISTERS funzione di callback (wdm.h)
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) |