fonction de rappel DMA_RESET_HANDLER (netdma.h)
dans Windows 8 et versions ultérieures.
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 paramètre fonction ProviderAllocateDmaChannel.
Valeur de retour
ProviderResetChannel 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 ProviderResetChannel est une fonction facultative pour les fournisseurs NetDMA. L’interface NetDMA appelle la fonction ProviderResetChannel du pilote du fournisseur DMA 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 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 de réinitialisation terminée, le canal DMA doit être dans l’état initial qui existait après l’allocation du canal. Après l’appel de l’interface NetDMA ProviderResetChannel, le fournisseur DMA ne peut accéder à aucun des descripteurs DMA précédemment soumis. Le canal DMA doit être prêt pour que l’interface NetDMA appelle la fonction ProviderStartDma.
NetDMA appelle ProviderResetChannel 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 |