Compartir a través de


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

Nota No se admite la interfaz NetDMA.

en Windows 8 y versiones posteriores.

 
La función ProviderAbortDma cancela las transferencias DMA asociadas a un canal DMA.

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:

Código devuelto Descripción
STATUS_SUCCESS
La operación se ha completado correctamente.
STATUS_UNSUCCESSFUL
Error en la operación por motivos no especificados.

Comentarios

La función ProviderAbortDma es una función opcional para los proveedores netDMA. La interfaz NetDMA puede llamar a una 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 los informes de estado de finalización están habilitados, el motor DMA escribe el estado NetDmaTransferStatusHalted en la dirección especificada en los miembros CompletionVirtualAddress y CompletionPhysicalAddress 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 hasta que se reinicie la transferencia.

NetDMA llama a ProviderAbortDma en IRQL <= DISPATCH_LEVEL.

Requisitos

Requisito Value
Cliente mínimo compatible Compatible con controladores netDMA 1.0 en Windows Vista.
Plataforma de destino Windows
Encabezado netdma.h (incluya Netdma.h)
IRQL <= DISPATCH_LEVEL

Consulte también

NET_DMA_CHANNEL_PARAMETERS

ProviderAllocateDmaChannel

ProviderAppendDma

ProviderStartDma