DMA_RESET_HANDLER fonction de rappel (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 Fonction ProviderAllocateDmaChannel .
Valeur retournée
ProviderResetChannel retourne l’une des valeurs status suivantes :
| Code de retour | 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, 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 |