DMA_ABORT_HANDLER fonction de rappel (netdma.h)
dans Windows 8 et versions ultérieures.
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 paramètre fonction ProviderAllocateDmaChannel.
Valeur de retour
ProviderAbortDma retourne l’une des valeurs d’état suivantes :
| Retourner le code | Description |
|---|---|
|
L’opération s’est terminée avec succès. |
|
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 planifiés sur un canal DMA.
Dans ProviderAbortDma, le fournisseur DMA doit mettre fin immédiatement au transfert sans terminer le transfert des données associées au descripteur DMA actuel. Si le rapport d’état d’achèvement est activé, le moteur DMA écrit l’état NetDmaTransferStatusHalted dans l’adresse spécifiée dans le CompletionVirtualAddress et CompletionPhysicalAddress membres dans le structure NET_DMA_CHANNEL_PARAMETERS.
Une fois l’opération d’abandon terminée, le canal DMA doit être prêt pour l’interface NetDMA pour appeler la fonction ProviderStartDma. L’interface NetDMA n’appelle pas la fonction ProviderAppendDma jusqu’à ce que le transfert soit redémarré.
NetDMA appelle ProviderAbortDma au <IRQL = DISPATCH_LEVEL.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Pris en charge pour les pilotes NetDMA 1.0 dans Windows Vista. |
| plateforme cible | Windows |
| d’en-tête | netdma.h (include Netdma.h) |
| IRQL | <= DISPATCH_LEVEL |