Compartir a través de


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)

Consulte también

AllocateAdapterChannel

DMA_ADAPTER

DMA_OPERATIONS

FlushAdapterBuffers

FreeMapRegisters

IoGetDmaAdapter

MapTransfer