DMA_RESET_HANDLER función de devolución de llamada (netdma.h)
en Windows 8 y versiones posteriores.
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 |
|---|---|
|
La operación se completó correctamente. |
|
Error en la operación por motivos no especificados. |
Observaciones
La función ProviderResetChannel es una función opcional para los proveedores de 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 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 restablecimiento, el canal DMA debe estar en el estado inicial que existía después de asignar el canal. Después de llamar a la interfaz NetDMA 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 de.
NetDMA llama a ProviderResetChannel en IRQL <= DISPATCH_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Compatible con controladores netDMA 1.0 en Windows Vista. |
| de la plataforma de destino de | Windows |
| encabezado de | netdma.h (incluya Netdma.h) |
| irQL | <= DISPATCH_LEVEL |