DMA_ABORT_HANDLER fonction de rappel (netdma.h)

  • Article
Note L’interface NetDMA n’est pas prise en charge

dans Windows 8 et versions ultérieures.

 
La fonction ProviderAbortDma annule tous les transferts DMA associés à un canal DMA.

Syntaxe

DMA_ABORT_HANDLER DmaAbortHandler;

NTSTATUS DmaAbortHandler(
  [in] PVOID ProviderChannelContext
)
{...}

Paramètres

[in] ProviderChannelContext

Pointeur qui identifie la zone de contexte d’un canal DMA. Le fournisseur DMA a retourné ce handle à NetDMA à l’emplacement spécifié dans le paramètre pProviderChannelContext du Fonction ProviderAllocateDmaChannel .

Valeur retournée

ProviderAbortDma retourne l’une des valeurs de status suivantes :

Code de retour Description
STATUS_SUCCESS
 L’opération s’est terminée avec succès.
STATUS_UNSUCCESSFUL
 L’opération a échoué pour des raisons non spécifiées.

Remarques

La fonction ProviderAbortDma est une fonction facultative pour les fournisseurs NetDMA. L’interface NetDMA peut appeler la fonction ProviderAbortDma d’un pilote de fournisseur DMA, le cas échéant, pour abandonner tous les transferts DMA qui ont été planifiés sur un canal DMA.

Dans ProviderAbortDma, le fournisseur DMA doit arrêter immédiatement le transfert sans terminer le transfert des données associées au descripteur DMA actuel. Si la saisie semi-automatique status création de rapports est activée, le moteur DMA écrit le status NetDmaTransferStatusHalted dans l’adresse spécifiée dans les membres CompletionVirtualAddress et CompletionPhysicalAddress dans le NET_DMA_CHANNEL_PARAMETERS structure.

Une fois l’opération d’abandon terminée, le canal DMA doit être prêt pour que l’interface NetDMA appelle la fonction ProviderStartDma . L’interface NetDMA n’appellera la fonction ProviderAppendDma qu’après le redémarrage du transfert.

NetDMA appelle ProviderAbortDma à IRQL <= DISPATCH_LEVEL.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge pour les pilotes NetDMA 1.0 dans Windows Vista.
Plateforme cible Windows
En-tête netdma.h (inclure Netdma.h)
IRQL <= DISPATCH_LEVEL

Voir aussi

NET_DMA_CHANNEL_PARAMETERS

ProviderAllocateDmaChannel

ProviderAppendDma

ProviderStartDma