PFREE_ADAPTER_CHANNEL función de devolución de llamada (wdm.h)
El FreeAdapterChannel rutina libera el controlador DMA del sistema cuando un controlador ha completado todas las operaciones 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
Ninguno
Observaciones
FreeAdapterChannel no es una rutina del sistema que se puede llamar directamente por 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.
Después de que un controlador haya transferido todos los datos y llamado FlushAdapterBuffers, llama a FreeAdapterChannel para liberar el controlador DMA del sistema asignado previamente 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 AdapterControl rutina devuelve KeepObject.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows 2000. |
| de la plataforma de destino de | Escritorio |
| encabezado de | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| irQL | DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | IrqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm) |