Macro NdisMCompleteDmaTransfer (ndis.h)
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 préparation des transferts DMA supplémentaires.
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 l’état 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 appelée 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é passée à NdisMSetupDmaTransfer.
_L
Longueur en octets du transfert. Cette valeur a également été passée à NdisMSetupDmaTransfer.
_M_
TRUE si le transfert était de l’hôte vers la carte réseau, par exemple une opération d’envoi.
Valeur de retour
Aucun
Remarques
NdisMCompleteDmaTransfer doit être appelée avec WriteToDevice définie sur TRUE avant que les données transférées ne 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.