DMA_ABORT_HANDLER función de devolución de llamada (netdma.h)

Sintaxis

DMA_ABORT_HANDLER DmaAbortHandler;

NTSTATUS DmaAbortHandler(
  [in] PVOID ProviderChannelContext
)
{...}

Parámetros

[in] ProviderChannelContext

Puntero que identifica el área de contexto de un canal DMA. El proveedor DMA devolvió este identificador a NetDMA en la ubicación especificada en el parámetro pProviderChannelContext del función providerAllocateDmaChannel.

Valor devuelto

ProviderAbortDma devuelve uno de los siguientes valores de estado:

Observaciones

La función ProviderAbortDma de es una función opcional para los proveedores de NetDMA. La interfaz NetDMA puede llamar a la función ProviderAbortDma del controlador de proveedor DMA, si existe, para anular todas las transferencias DMA programadas en un canal DMA.

En ProviderAbortDma, el proveedor DMA debe finalizar la transferencia inmediatamente sin completar la transferencia de los datos asociados al descriptor DMA actual. Si la notificación de estado de finalización está habilitada, el motor de DMA escribe el estado NetDmaTransferStatusHal ted en la dirección especificada en la dirección especificada en el CompletionVirtualAddress y CompletionPhysicalAddress miembros en el NET_DMA_CHANNEL_PARAMETERS estructura.

Una vez completada la operación de anulación, el canal DMA debe estar listo para que la interfaz NetDMA llame a la función ProviderStartDma. La interfaz NetDMA no llamará a la función providerAppendDma de hasta que se reinicie la transferencia.

NetDMA llama a ProviderAbortDma en IRQL <= DISPATCH_LEVEL.

Requisitos

Consulte también

NET_DMA_CHANNEL_PARAMETERS

ProviderAllocateDmaChannel

ProviderAppendDma

ProviderStartDma