Función NetDmaProviderStop (netdma.h)

Artículo
03/08/2024

Nota No se admite la interfaz NetDMA

en Windows 8 y versiones posteriores.

La función NetDmaProviderStop notifica a la interfaz NetDMA que todos los canales DMA asociados a un proveedor DMA ya no están disponibles para las transferencias de DMA.

Sintaxis

NET_DMA_EXPORT VOID NetDmaProviderStop(
  [in] PVOID NetDmaProviderHandle
);

Parámetros

[in] NetDmaProviderHandle

Identificador que identifica un proveedor DMA. El controlador del proveedor DMA recibió este identificador de la interfaz NetDMA en una llamada a . Función NetDmaRegisterProvider .

Valor devuelto

None

Observaciones

Un controlador del proveedor DMA llama a la función NetDmaProviderStop para notificar a la interfaz NetDMA que un motor DMA, que se inició mediante una llamada a la función NetDmaProviderStart , ya no está disponible.

El controlador del proveedor DMA debe llamar a NetDmaProviderStop antes de llamar a la función NetDmaDeregisterProvider para anular el registro de un proveedor DMA.

Normalmente, los controladores del proveedor DMA llaman a NetDmaProviderStop mientras se controla el IRP_MN_REMOVE_DEVICE o IRP_MN_STOP_DEVICE IRP.

Un controlador del proveedor DMA puede llamar a NetDmaProviderStop y NetDmaProviderStart tantas veces como la aplicación requiera después de registrar el proveedor DMA y antes de anular el registro del proveedor DMA. Si se reinicia un motor DMA después de llamarlo NetDmaProviderStop, el controlador del proveedor DMA puede especificar nuevos atributos en . NET_DMA_PROVIDER_ATTRIBUTES estructura en el parámetro ProviderAttributes de NetDmaProviderStart.

La interfaz NetDMA espera a que las operaciones de DMA pendientes se completen y liberen todos los canales DMA asignados antes de que vuelva de la función NetDmaProviderStop .

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con controladores netDMA 1.0 en Windows Vista.
Plataforma de destino	Universal
Encabezado	netdma.h (incluir Netdma.h)
IRQL	PASSIVE_LEVEL