PFREE_ADAPTER_CHANNEL función de devolución de llamada (wdm.h)
La rutina FreeAdapterChannel libera el controlador DMA del sistema cuando un controlador ha completado todas las operaciones de DMA necesarias para satisfacer el IRP actual.
Sintaxis
PFREE_ADAPTER_CHANNEL PfreeAdapterChannel;
void PfreeAdapterChannel(
[in] PDMA_ADAPTER DmaAdapter
)
{...}
Parámetros
[in] DmaAdapter
Puntero a la estructura DMA_ADAPTER devuelta por IoGetDmaAdapter que representa el adaptador de bus-master o el controlador DMA.
Valor devuelto
None
Observaciones
FreeAdapterChannel no es una rutina del sistema que se puede llamar directamente por su nombre. Esta rutina solo se puede llamar por puntero de la dirección devuelta en una estructura de DMA_OPERATIONS . Los controladores obtienen la dirección de esta rutina llamando a IoGetDmaAdapter.
Una vez que un controlador ha transferido todos los datos y ha llamado FlushAdapterBuffers, llama a FreeAdapterChannel para liberar el controlador DMA del sistema que se asignó anteriormente con una llamada a AllocateAdapterChannel.
FreeAdapterChannel libera los registros de mapa asignados por una llamada anterior a AllocateAdapterChannel. Un controlador llama a esta rutina solo si su rutina AdapterControl devuelve KeepObject.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows 2000. |
| Plataforma de destino | Escritorio |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | DISPATCH_LEVEL |
| Reglas de cumplimiento de DDI | IrqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm) |