Macro NdisMCompleteDmaTransfer (ndis.h)

  • Article

La fonction NdisMCompleteDmaTransfer indique qu’une opération de transfert DMA système est terminée. Il réinitialise le contrôleur DMA système en vue d’autres transferts DMA.

Syntaxe

void NdisMCompleteDmaTransfer(
   _S,
   _H,
   _B,
   _O,
   _L,
   _M_
);

Paramètres

_S

Pointeur vers une variable fournie par l’appelant dans laquelle cette fonction retourne le status final du transfert DMA, qui peut être l’un des éléments suivants :

NDIS_STATUS_SUCCESS

Les données ont été transférées et vidées vers la mémoire hôte ou vers l’appareil pour maintenir l’intégrité des données.

NDIS_STATUS_RESOURCES

Le contrôleur DMA a été libéré, mais le transfert de données peut être incohérent.

_H

Handle retourné lorsque la fonction MiniportInitializeEx a appelé le Fonction NdisMRegisterDmaChannel .

_B

Pointeur vers le descripteur de mémoire tampon précédemment passé à NdisMSetupDmaTransfer.

_O

Décalage d’octet auquel le transfert a commencé. Cette valeur a également été transmise à NdisMSetupDmaTransfer.

_L

Longueur en octets du transfert. Cette valeur a également été transmise à NdisMSetupDmaTransfer.

_M_

TRUE si le transfert s’est effectué de l’hôte vers la carte réseau, comme, par exemple, une opération d’envoi.

Valeur de retour

None

Remarques

NdisMCompleteDmaTransfer doit être appelé avec WriteToDevice défini sur TRUE avant que les données transférées soient considérées comme présentes dans la mémoire de la carte réseau. NdisMCompleteDmaTransfer doit être appelé avec WriteToDevice défini sur FALSE avant que les données transférées puissent être lues à partir de la mémoire hôte.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisMCompleteDmaTransfer (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (consultez NdisMCompleteDmaTransfer (NDIS 5.1)) dans Windows XP.
Plateforme cible Universal
En-tête ndis.h (inclure Ndis.h)
IRQL <= DISPATCH_LEVEL
Règles de conformité DDI Irql_MCO_Function(ndis)

Voir aussi

MiniportInitializeEx

NdisMRegisterDmaChannel

NdisMSetupDmaTransfer