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

  • Artículo
Nota No se admite la interfaz NetDMA

en Windows 8 y versiones posteriores.

 
La función ProviderResetChannel restablece un canal DMA al estado inicial que existía después de asignar el canal DMA.

Sintaxis

DMA_RESET_HANDLER DmaResetHandler;

NTSTATUS DmaResetHandler(
  [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

ProviderResetChannel 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 ProviderResetChannel es una función opcional para los proveedores netDMA. La interfaz NetDMA llama a la función ProviderResetChannel del controlador del proveedor DMA, si existe, para restablecer un canal DMA.

En ProviderResetChannel, el proveedor netDMA debe finalizar cualquier transferencia activa inmediatamente sin completar la transferencia de los datos asociados al descriptor DMA actual. Si se habilita la notificación de estado de finalización, el motor DMA escribe el estado NetDmaTransferStatusHalted en la dirección especificada en los miembros CompletionVirtualAddress y CompletionPhysicalAddress en la dirección especificada en los miembros CompletionVirtualAddress. NET_DMA_CHANNEL_PARAMETERS estructura.

Una vez completada la operación de restablecimiento, el canal DMA debe estar en el estado inicial que existía después de asignar el canal. Después de que la interfaz NetDMA llame a ProviderResetChannel, el proveedor DMA no puede acceder a ninguno de los descriptores DMA enviados anteriormente. El canal DMA debe estar listo para que la interfaz NetDMA llame a la función ProviderStartDma .

NetDMA llama a ProviderResetChannel 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 (incluir Netdma.h)
IRQL <= DISPATCH_LEVEL

Consulte también

NET_DMA_CHANNEL_PARAMETERS

ProviderAllocateDmaChannel

ProviderStartDma