PFREE_ADAPTER_OBJECT función de devolución de llamada (wdm.h)

Artículo
02/27/2024

La rutina FreeAdapterObject libera el objeto de adaptador especificado después de que un controlador haya completado todas las operaciones DMA.

Sintaxis

PFREE_ADAPTER_OBJECT PfreeAdapterObject;

void PfreeAdapterObject(
  [in] PDMA_ADAPTER DmaAdapter,
  [in] IO_ALLOCATION_ACTION AllocationAction
)
{...}

Parámetros

[in] DmaAdapter

Puntero a una estructura de DMA_ADAPTER . Esta estructura es el objeto de adaptador que se va a liberar. Este objeto representa el dispositivo DMA maestro de bus del controlador o el canal DMA del sistema. El autor de la llamada obtuvo este puntero de una llamada anterior a la rutina IoGetDmaAdapter .

[in] AllocationAction

Tipo de desasignación que solicita el controlador que llama. Establezca este parámetro en un valor de enumeración IO_ALLOCATION_ACTION . Para obtener más información, vea la sección Comentarios.

Valor devuelto

None

Observaciones

FreeAdapterObject no es una rutina del sistema a la que se puede llamar directamente por su nombre. Solo el puntero de la dirección devuelta en una estructura de DMA_OPERATIONS puede llamar a esta rutina. Los controladores obtienen la dirección de esta rutina llamando a IoGetDmaAdapter con el miembro Version del parámetro DeviceDescription establecido en DEVICE_DESCRIPTION_VERSION3. Si IoGetDmaAdapter devuelve NULL, la rutina no está disponible en la plataforma.

Si AllocationAction = DeallocateObject, la llamada FreeAdapterObject libera el objeto de adaptador y libera los registros de mapa que se pueden asignar para este objeto.

Si AllocationAction = DeallocateObjectKeepRegisters, la llamada FreeAdapterObject libera el objeto de adaptador, pero no libera ningún registro de mapa. En este caso, el controlador debe liberar explícitamente los registros de mapa asignados llamando a la rutina FreeMapRegisters .

Si AllocationAction = KeepObject, la llamada FreeAdapterObject no tiene ningún efecto.

FreeAdapterObject se puede usar para desasignar recursos DMA asignados por llamadas a las rutinas AllocateAdapterChannelEx, GetScatterGatherListEx y BuildScatterGatherListEx . Si el controlador llama a una de estas rutinas de forma sincrónica, el parámetro ExecutionRoutine es opcional y se puede omitir. En este caso, el controlador puede usar el objeto de adaptador y los registros de mapa asignados por la llamada. Una vez que el controlador inicia la transferencia DMA, el controlador puede llamar a FreeAdapterObject para desasignar el objeto de adaptador y, si es necesario, el mapa se registra.

La rutina FreeAdapterChannel es similar a FreeAdapterObject. FreeAdapterChannel siempre libera el objeto de adaptador y los registros de mapa asignados. Este comportamiento es similar al de FreeAdapterObject si AllocationAction = DeallocateObject.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 8.
Plataforma de destino	Escritorio
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
IRQL	<= DISPATCH_LEVEL