DMA_SUSPEND_HANDLER función de devolución de llamada (netdma.h)
en Windows 8 y versiones posteriores.
Sintaxis
DMA_SUSPEND_HANDLER DmaSuspendHandler;
NTSTATUS DmaSuspendHandler(
[in] PVOID ProviderChannelContext,
[out] PPHYSICAL_ADDRESS *pLastDescriptor
)
{...}
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.
[out] pLastDescriptor
Puntero a una variable que contiene la dirección física del último descriptor DMA procesado correctamente. El proveedor DMA proporciona esta dirección antes de volver de ProviderSuspendDma.
Valor devuelto
ProviderSuspendDma 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 providerSuspendDma de es una función opcional para los proveedores de NetDMA. La interfaz NetDMA puede llamar a la función de ProviderSuspendDma, si existe, para suspender temporalmente las transferencias DMA que estén en curso en un canal DMA.
El proveedor DMA completa la transferencia del descriptor DMA actual antes de que vuelva de ProviderSuspendDma. Si la notificación de estado de finalización está habilitada, el motor de DMA escribe el estado NetDmaTransferStatusSuspend en la dirección especificada en la dirección especificada en el CompletionVirtualAddress y Los miembros CompletionPhysicalAddress en el NET_DMA_CHANNEL_PARAMETERS estructura.
Mientras se suspenden las transferencias DMA, la interfaz NetDMA puede modificar la lista vinculada del descriptor DMA (por ejemplo, para insertar o eliminar descriptores).
La interfaz NetDMA llama a la función providerResumeDma de para reanudar las operaciones DMA suspendidas llamando a ProviderSuspendDma.
NetDMA llama a ProviderSuspendDma 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 |