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 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) |