DMA_RESET_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 ProviderResetChannel réinitialise un canal DMA à l’état initial qui existait après l’allocation du canal DMA.

Syntaxe

DMA_RESET_HANDLER DmaResetHandler;

NTSTATUS DmaResetHandler(
  [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

ProviderResetChannel retourne l’une des valeurs 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 ProviderResetChannel est une fonction facultative pour les fournisseurs NetDMA. L’interface NetDMA appelle la fonction ProviderResetChannel du pilote du fournisseur DMA, le cas échéant, pour réinitialiser un canal DMA.

Dans ProviderResetChannel, le fournisseur NetDMA doit mettre fin immédiatement à tout transfert actif 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 de réinitialisation terminée, le canal DMA doit être dans l’état initial qui existait après l’allocation du canal. Une fois que l’interface NetDMA a appelé ProviderResetChannel, le fournisseur DMA ne peut accéder à aucun des descripteurs DMA précédemment soumis. Le canal DMA doit être prêt pour l’interface NetDMA pour appeler la fonction ProviderStartDma .

NetDMA appelle ProviderResetChannel à 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

ProviderStartDma